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SECTION I: 
In the Beginning. . . 


Let there be... Panorama! Sculpt a landscape in minutes, not eons. Form a river system while you, not 
generations, watch. Lay a soft blanket of haze over the hills and valleys, and whoosh it away at your whim. 
Welcome to Panorama, the fractal landscape generator program that puts you in charge... the landscape 
drawing program that puts mathematics to work to make pretty (or far-out) pictures. 


First things first. 


For virus protection and other reasons, Panorama is not shipped as a bootable program disk. You must 
get your computer running before loading Panorama. In addition, the disk on which your computer is booted 
must have a certain file in its “libs:” device, in order for Panorama to Operate properly. You needn’t trouble 
yourself with understanding the device or anything. Just run the Panoramalnstall program on the main disk, 
and it will perform the necessary operation for you. If you boot your computer on a different disk, however - a 
different floppy, for example, you must run the Panoramalnstall program for it, too. Jf Panorama fails to 
execute, run the Panoramalnstall program. 


Making a backup disk 


If you have not already done so, please make one backup copy of each of the original, Panorama disks. 
Use these backup copies as your “working” disks, and store the ori ginals safely away. If you don’t know how 


See The Automatic Demo! 


Got the program running? And Arexx, too? To see a self-running demo, hit 10> If you have 


ARexx fired up along with Panorama, the program will show off for you while you watch. (Stop the 
demo by pressing 4iSC>while a picture is being drawn). 
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to copy a disk with your computer, refer to Appendix A: Basic Training for some instructions on backing up 
and getting going. ; 

Harddisk users, Panorama can also be installed on your computer’s harddisk drive, and there it will live — 
happily ever after. Instructions for installing on your harddisk (a simple process) are contained in Appendix B: 
Harddisk Installation. You can do that now, if you prefer, or come back to it later. Panorama will also work 
fine from floppies, though it will take a while to load. It will even work from a single floppydisk drive, since all 
of its program code is loaded at once, not paged from disk. 

Okay, ready to go. .. Moving right along. .. 


A get-aquainted, whirlwind tutorial 


Quick, now, before the disks get cool just out of the box, let’s take a fast tour of the Panorama program, 
So you can see what you’ve got and what you can do with it. We’ll make the program jump through some > 
hoops and show off, before getting down to the business of showing you how to make it do all of its tricks 
yourself. For this tour, you should have performed the Panoramalnstall procedure, and you should have your 
computer up and running. Oh, and you’!! need to keep this manual handy, as well as your original Panorama — 
disks. 


What you’ve got 


Panorama is a program for making something out of nothing. Well, not really nothing, but nothing you 
can see, feel, or touch. The program uses mathematics to make pictures of landscapes that don’t exist. Might 
not even be possible to exist. Might not even be Earthbound ones, in fact. Panorama also makes pictures of _ 
landscapes that do exist, by loading special data files that are available for lots of places on Earth and its 
neighbors. Before heading for outer space, however, let’s come “down to Earth” and have the program show 
off for you. If you have ARexx running in your machine, you can see an automated demo by hitting the #10> a 
key. That sets the Panorama demo script a-going, and it keeps on going till you stop it with a tap on the &SC> 
key. It’s a cool demo, for sure, but it doesn’t teach you much about how to use the program, so we begin that 
process with. . . 


Dumb Tutorial Number One. 


This is really simple tutorial. If you follow through it with the program running and your mousefinger 
a-twitching at the right places, you’ll end up with a gorgeous picture on your computer screen, joy in your 
heart, and a buming desire to dig in for serious with the this tome of documentation. Interested? Let’s get a 
going. , 

First, load the program. By the way, as we go along, refer to the Basic Training appendix anytime you 
encounter instructions for operating the computer (“‘doubleclick?”’) that you don’t understand. Put your freshly — 
made backup copy of the Panorama Program Disk in any drive, wait for the drive light to go out, and 
doubleclick the icon (It will magically appear) for the disk. When you do this, a window will open containing 
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The Control Window 


some more icons. Next, doubleclick the icon labeled “Panorama.” You can’t miss it; it’s a big one. 

When the Panorama Control Window appears, using the right mousebutton, pull down the menuitem 
“New Landscape.’ In the requester box that appears, click ‘Timer.’ Another one appears, and click ‘OK’ in it. 
We’re not going to actually use the data we generate here, just show off this feature and how it works. So, don’t 
worry about doing anything wrong in this part of the tutorial. We'll come back to the requesters we’ve skipped 
later on, too. 

Notice that the “Height” screen that appears has in its center a bunch of lines that look like a collapsing 
circus tent. You can move the intersections of these lines up and down by pointing to them with the mouse, 
holding down the left mousebutton, and moving the mouse. Do that now. Pick one (Click it with the left 
mousebutton); hold the button down, and move the mouse. As you move the spider-shaped bunch of lines up or 
down the screen (They won’t move sideways), you should see them change color from blue (near the bottom) 
through brown, green, and grey, to white (at the top of the screen), depending on where you let go of the 
mousebutton. Think of these lines as the roughest possible description for a chunk of terra firma. 

The white lines become snow-strewn mountaintops. The blue lines define “basins”; a point from which 
blue lines radiate is lower than any of its neighboring points. Basins can be filled with water and be made to 
appear as lakes when Panorama draws the landscape. Streams will flow from the lakes and from springs in the 
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mountains, and will course down the slopes following the contour of the landscape in waterfalls and rivulets, 
cascades and placid meandering rivers, just as Mother Nature did with Planet Earth a few million years ago 
while nobody was watching too closely. 

Using Panorama’s ‘Height’ screen, the one with the spiderwebs of lines all over the place, you.can 
sculpt the rudimentary landscapes any way you want them. Change the positions of several of the spiderwebs, 
and observe how they affect each other, as you move them from high to low, mountaintop to valley to the 
bottom of a lake. You can have giant mountains or rolling hills, Steep gorges or lazy, meandering valleys. The 
final landscape will be the result of this initial sculpting, with the addition of thousands of random fluctuations 
guided and controlled by a number of fractal parameters. 


But that’s not all... 


When you’re done sculpting, click the ‘OK’ button. There are other buttons, but let them be for now. co 
When you click ‘OK’ not much happens. The landscape doesn’t change, but the title of the screen invites you 
to “locate springs.” Click near an intersection of lines, and ifa neighboring point is lower the first point 
becomes a spring from which flows a river (shown as blue lines) which flows down as steeply as it can until it 8, 
reaches the bottom of a basin or the edge of the landscape. Click the “Redo” button if you change your mind 
and want to start over. Click ‘OK’ when you’re done here, and the program will put an aerial view of the rough 
landscape you’ve created into the Control Window. 
Each point in the landscape is represented by a 
rectangle colored as a shade of green, brown, or 
grey depending on the height of the point. Don’t 
worry about the blocky look. We’ll fix all that — 
shortly, in a big way. 2 


The story up to now 


So far, we’ve figured out how to make land, 
water, mountains, and rivers in their crudest, most 
elementary form. However, you should know that 
carving out landscape data with Panorama’s ‘New Landscape’ facility isn’t the only way to get landscape data 
into the program. 

Panorama can also load data files, perhaps for a fractal landscape saved from a previous session, or 
perhaps for a real, genuine landscape, either on our home planet or from someplace none too accessible by 
riding lawnmower. Like Mars. The program GeoRama (included on the Panorama program disk) will convert 
Digital Elevation Model (“DEM”) data, originally from the United States Geological Survey but compressed aos 
into an Amiga IFF kind of format, to a Panorama data file. The definition for these files is included in this 
manual. 

By loading data files output by GeoRama, you can create pictures of real places as readily as the 
hypothetical ones defined by the ‘New Landscape’ design screen. For now, let’s just load some data that has 
been stored on the program disk especially for use in this get-going tutorial. 


SS ee 
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If you’ve created data in the design screen that you’d like to work with later on, select ‘Save Data’ from 
the leftmost pulldown menu, and proceed in the normal way for saving a file in the file requester that comes up. 
Then continue with the tutorial. 


Loading Data 


To load data from the disk, pull down the 
menuitem ’Load Data.’ It’s about halfway down 
under the ’Actions’ menu. This action loads data into 
the program, just as though you had manipulated the 
‘New Landscape’ to your liking and perhaps 
“Increase(d) Level” a few times. Pick out the file 
“Test.data” from the selections displayed in the file 
requester window. If you just doubleclick the 
filename, you won’t have to do anything else to get 
the load operation going. 

When Panorama loads data, it loads the 
elevation information (Okay, it also loads some 
more stuff we’ll get to later). Information about the 
position of the camera and various other rendering 
parameters and switches can be stored in another 
kind of file, called a “Settings” file. For this quick 
tour, just select ‘Load Settings,’ one of the items in the ‘Actions’ pulldown menu, and doubleclick the file 
named “‘Test.set” from the Panorama disk. 

‘Settings’ files contain the parameters needed for drawing the screen. You’re saying to the computer, 
“Suppose a landscape that looks like this-- load ‘Data’ file --were to be viewed in this manner from this 
location with this type of camera lens--load ‘Settings’ file--then, how would it look on the screen? The 
computer answers this question by using all the information in the “data” file, applying all of the switches and 
parameters from the “‘settings” file, and generating a picture on the screen that fits all of the above and matches 


the definition for the “screen” that you’ve set up. You can, for example, generate a picture that is much larger 
than the screen. Cool. 





Drawing the picture 


Data loaded? Settings loaded? It’s picture time! Pull down ‘Draw Preview’ from the ‘Actions’ menu. 
This will make Panorama draw a wireframe representation on your screen. The wireframe’s purpose is to show 
you the composition of your picture before you invest time in plotting it for real. While Panorama is drawing a 
preview you can interrupt the process by hitting <ESC> or by clicking the left mousebutton. 

Okay, now draw the picture for real! Pull down the menuitem ‘Draw Picture,’ from the ‘Actions’ menu. 
All resolution, view, palette, contrast, and other parameters have been loaded with the ‘Settings’ file, so when 
your computer is finished creating the picture, you’ ll end up with Panorama.pic emblazoned on your monitor. 
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is pi i SAS 
This picture appears on the outside of the package, or you < SS — < 
Se S 


can see it electronically by doubleclicking its icon on the 
Panorama Support Disk. Don’t worry if your screen 
looks different from the included IFF version. 

The sample picture is in low resolution, no 
overscan, Recursion Level 4 (more about these levels 
later). It isn’t a bad picture, all things considered, but this 


is not by a long shot an example of the best picture 
Panorama can do. 


Good, bad or indifferent, did the picture come out 
on your screen? Now we’re cooking! 





Saving a picture _ 


After you create a picture, you'll surely want to preserve it for posterity. Since you can’t leave your 
computer running for posterity to come by and have a look, you’ ll want to store your picture, in addition to the ~~ 
data and settings with which you made it, onto a disk. To save a Panorama picture as an IFF file, select the 
“Save Picture’ item in the ‘Project? menu on the picture screen. The file requester will come up over the picture. 


Enter the path and the filename for the picture, and click ‘OK.’ Click “CANCEL? to abort. No filename 
extension is added to the filename you provide. 
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SECTION II: 
Pounding math into pictures 


Mama, don’t take my Kodachrome away. . . 
- Paul Simon 


With Panorama you create your own worlds, establishing rivers, streams, waterfalls, lakes, seas, and 
dry land as you choose, and defining mountain ranges, the roughness of the terrain, and the height and slope 
of the crags and valleys. You can choose to view these landscapes from any direction, from any height, and 
from any distance, using a variety of “camera lenses” from 11-mm fisheye to 3000-mm telephoto, all in 
accurate photographic perspective, just as though the mountains, the clouds, and the lakes were all real, and 
as though the ‘“‘camera” really could hover a foot above the center of the lake where you put it. The wand 
that works this magic is mathematics, instead of Kodachrome film. In Panorama, the raw material from 
which you build your world is fractal math calculations, capable of building landscapes of surpassing 
beauty, comprised of mathematically generated, incredibly realistic details such as trees, clouds, water, and 
ground cover. All of this can produce a remarkably convincing simulation of real landscapes, no matter how 
far your imagination roams. 

Panorama is algorithmically correct, and mathematically with-it. The program lets you experiment at 
the forefront of current research in fractals. Original, fractal landscape algorithms that are unique to 
Panorama \et you adjust many parameters for the formulas simply and understandably, in order to create 
strikingly different scenes, even from the same data. Dr. Benoit Mandelbrot, Father Fractal himself, has 
invited Panorama’s author to lecture about this new approach to fractal landscapes and to demonstrate 
developing versions of Panorama at Yale and IBM. Yet, Panorama is more than a math toy. For one thing, it 
makes great pictures. You can use the pictures it creates as backgrounds for video titling, as playfields for 
video gaming, or as the starting point for fine art, illustration and graphic designs. You can wrap them as 
bitmaps onto objects in your raytracing and rendering programs. Or you can frame them and hang them on 
your wall. In addition, the program permits unattended operation for the creation of animations of any 
length, generated and recorded automatically, including automatic support for single-frame video recording. 


Cm 
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So, you can conduct a fly-by, or a fly-through, or follow a river as it meanders through lush, green valleys. 


Intuitive user interface 


The program makes it easy to create striking pictures and picture sequences without knowing anything 
about fractals or math, algorithms or even computers. The key to this ability is the program’s intuitive user 
interface, with most options and choices stated in plain English. You can go with preset values for the fractal 
and rendering parameters or adjust them individually to your liking, using the handy quick-access buttons on 
the righthand side of the screen. You can import a group of parameters controlling one aspect of the picture, 
such as clouds, waves, or trees, from a Settings file, without importing anything else the file might contain. 
The program gives you control over absolutely everything, in a variety of ways and to any degree of 
complexity. 

Panorama also permits loading landscape data created by other people, or data from so-called 
“DEM” files that you can use to create pictures of real places around the world or on other worlds. 

The pictures from Panorama are fully shaded, with true shadows. You can control the direction and 
elevation of the sun, as well as the subtleties of the coloring of the landscape being created. The rendering 


includes some features normally associated with raytracing, such as shimmering reflections of the sky in the 
waves. 


Animation of the finished landscapes can be achieved through an internal scripting language, which 
makes it easy to automate the generation of successive frames of animations and to store and recall 
rendering configurations. Moreover, Panorama can be entirely controlled and operated with software 
through its ARexx port, and any program (or ARexx macro) which speaks ARexx can control Panorama’s 
many options. 

ARexx comes with AmigaDos 2.0. It can be added to earlier versions of the Amiga operating system 
by purchasing an ARexx language package. ARexx is a computer language which takes advantage of 
Amigas’ multitasking capabilities to implement interprocess communication. For instance, Panorama can 
produce individual frames of an animation, the images can be altered or combined with other images in 
DigiPaint 3.0 or ToasterPaint, and then the pictures can be compressed and combined into an animation 
using ASDG’s Art Department Professional “FRED” facility--all coordinated automatically by an ARexx 
program. 

Whether you are an artist, a graphics designer, illustrator, or a videographer in need of high quality 
landscape images, or if you’re fascinated by the use of fractal geometry to simulate nature, you’ll find 
Panorama to be a very useful creative tool. And great fun. 
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SECTION III: 


From the ground up 


Care and feeeding 


Panorama will run on all models of Amiga computers (including Amiga 1000’s) which have at least 2 
megabytes of memory and AmigaDos version 1.2 or higher, including Release 2.0 and above. The fact is, 
however, that there is no such thing as too much memory, and for extensive use of the 24-bit and overscan 


modes of the program--and especially to take advantage of multitasking other programs--the more memory 
your computer has, the better. 


One floppydisk drive is sufficient. The entire program is loaded into memory on startup, so Panorama 
won’t make you batty swapping disks into a single disk drive. However, it’s a very large program, and you’ll 
enjoy using it much more if you load and use it from a harddisk drive, which it happily supports. 
ee You don’t need anything else, except maybe a teensy bit of patience. 

On AmigaDos 1.2 systems, you’!l have to manually install the req.library program using the CLI 
window. 

Panorama uses the single-precision Motorola Fast Floating Point arithmetic built into all versions of 
the Motorola 68xxx series of microprocessors, so a 68881 or 68882 floating point math coprocessor is not 
required, For almost all of the calculations carried out in Panorama, Motorola Fast Floating Point is as fast 
as or faster than double precision arithmetic using coprocessors. You will achieve a very substantial speedup 
~~ Of the calculations and rendering with a 68020, 68030, or 68040 accelerator board and some 32-bit memory, 

particularly if you put the Amiga’s ROM routines (“Kickstart”) into the 32-bit RAM. The program 

“SetCPU” by Dave Haynie (under AmigaDos 1.3) or the program “CPU” provided with AmigaDos 2.0 and 
~- 2.1 will easily accomplish this. SetCPU is available on Fred Fish Disks #223 and #400. 


Operating Panorama 


To run Panorama from a floppy disk, insert the disk into a disk drive and wait for the drive’s activity 
light to go out. A disk icon labeled “Panorama3.0” will appear on your Workbench screen. Doubleclick the 
a 
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icon with the left mousebutton to open the disk window. A larger icon also named “Panorama” will be 
visible in the small window that appears. Doubleclick this icon (with the left mousebutton), and after a 
pause while the program is loaded, Panorama’s Control Window will open. This screen initially shows title, 
author, publisher and copyright information. When a landscape is in progress, this text is replaced by an 
aerial view of the landscape. , 

The next step is to get landscape data into the program to work on. Use the right mousebutton to 
browse through the pulldown menus. Notice that almost all of the menus are ghosted--“‘greyed out.” That’s 
because the program has no landscape to deal with. There are two ways it can get landscape information: 
load it, or create it. You’ve already seen a demonstration of both options, if you worked through the opening 
tutorial. Both options are accessible through active menuitems in the ‘Actions’ pulldown menu. If you wish ac 
to quit and do nothing, or if you need to close the program, select the menuitem ‘Quit’ from the ‘Actions’ 
menu, or Click the ‘Close’ gadget in the top left corner of the Control Window. 


Before you start... 


The ‘Switches’ and ‘Fractal’ menus allow you to choose among different modes of operation of = 
certain functions in Panorama and set up various parameters that control the fractal landscape generation 
process. Since defaults are provided for all these options and parameters, you can just leave them alone till 
you want to deal with them. 

However, if you want to change the fractal parameters, set therh before the landscape construction 
process begins, and before any increase in Recursion Level. Panorama applies fractal parameters as “rules 
of construction” as it builds a landscape through the various ‘Recursion Levels’ toward its goal: a picture of 
the landscape at one of the higher levels. There are three preset combinations of fractal parameters available = 
in the Fractal menu, named “Default FrDim,” “High FrDim,” and “Low FrDim,” In this menu, “FrDim” is 
short for “fractal dimension,” a term coined by Dr. Benoit Mandelbrot to describe how patterns of structure 
vary with scale. As applied to landscapes, “hi gh fractal dimension” means average slopes increase fairly a 
rapidly going from large to small scales, as in going from distances spanning entire mountain ranges down 
to scales of individual mountains. Low fractal dimension means average slopes are nearly the same on large 
and small scales, as in going from scales Spanning one or two large mountains down to small bumps and 
gullies. The Default preset is between these two extremes. To get a feel for this, select each of the presets in 
turn and run the “F10.Panorama” ARexx demo, observing the differences in the pictures. 

To have something to work with in exploring the program further, either load the Test.data file from 
the Panorama disk using the ‘Load Data’ command in the ‘Actions’ menu or create a fractal landscape as 
described in the opening tutorial. 


The Control Window es 


Most of the controls in Panorama are accessible from the program’s Control Window. To help you get 
acquainted with its possibilities, we'll take a guided tour of the Control Window. At the top, of course, 
there’s the title bar. This contains the Close gadget, which you can use to exit the program at any time. 


a 


22 ©1993 Push*Button Publishing 


Panorama will ask if you’re sure you want to quit, so you won’t accidentally lose any work. 


‘Would monsieur like to see a menu?’ 


Panorama’s Control Window has six primary pulldown menus: 

The ‘Actions’ menu: primary actions for generating and displaying landscapes, such as starting a new 
landscape, changing the Recursion Level, filling lakes and rivers, drawing a picture, disk file management, 
and Picture Script creation and execution. | 

The ‘Switches’ menu: Choose among different types of rendering, and set some general housekeeping 
toggles. Set options in the ‘Switches’ menu before initiating the action affected. 

The ‘Fractal’ menu. Set various fractal parameters which influence the landscape generation process. 

The ‘View’ menu. Load just the observer position and view direction from a Settings file, setup an 
overall bird’s eye (747) or astronauts eye (U2) view. of the landscape, and set the sun direction or the camera 
lens focal length. 

The ‘Features’ menu. Set various parameters for rendering the landscape, such as the vertical scale, 
sea level, the depth of the rivers, etc., or choose among preset parameter combinations for more complex 
features, such as the Contours and Cliffs, Waves, haze, and clouds. Individual elements of the landscape 
definition processlike “‘clouds”’can also be loaded from a file with this menu, and the file the parameters are 
taken from need not be the same for all of the features. 

The ‘Colors’ menu. Choose defaults or choose among preset colors for the Contours, the sky, the trees, 
the water, and other elements before the picture is drawn. Colors can also be loaded from a file. 

Before getting into the menus in a big way, let’s take a look at the rest of the Control Window. 


Map display 


The center of the screen contains a “map” of the landscape in progress. In this square, the program 
renders the Contours of the landscape using special map colors which vary from dark green at the lowest 
elevations to white at the highest elevations, just as though you were looking out the window of a rocket 
ship on your way to Mars. The program also draws sea, rivers and lakes in blue--appropriate, don’t you 
think? Anyway, this view of the landscape is present during the entire time you’re working in the program, 
and its appearance reflects the current size, shape, and placement of lakes, rivers, and sea. This map is 
intended to be a schematic view of the landscape, rather than a realistic depiction with shading and shadows; 
however, at higher Recursion Levels, the window shows a fairly convincing eagle’s-eye view of your 
landscape. 

At lower Recursion Levels, each point of the landscape is represented in the Map Window by a 
rectangle in the color appropriate to the point’s height. At Level 4, these rectangles are 3 pixels each, and at 
Level 5, only every third row of points is represented on the screen, one pixel for each point in that row. 

The horizontal position of the “camera,” the direction it points, and the width of the camera’s field of 
view are indicated by two red lines drawn over the map display. The lines intersect at the position of the 
camera, which might be outside the Map Window. The farther apart the lines, the wider the camera’s field of 
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view. Everything between the red lines is within the field of view, on the assumption that the camera is 
aimed horizontally. Of course, if a large object like a mountain is in the way, things behind the object are not 
visible from the camera’s position, even though the red lines go off into the distance. 


The lefthand side 


Numerical values for the observer position and view direction are displayed to the left of the Map 
Window. There are two modes for setting and displaying the observer position and view direction: ‘Angles’ 
and ‘Target.’ Click the button at the upper left of the screen to toggle between the two modes. 

In the default Angles mode, the observer position is described by a “compass angle” (CA) giving the 
direction of the observer from the center of the landscape as an angle measured clockwise from due North 
(North is to the right on the screen), a “distance” (D) of the observer from the center of the landscape, an 
“absolute height” (Z) and a “relative height” (RZ). 

The relative height is the height above the landscape at the observer’s horizontal position, or, when 
the observer is outside the landscape, at the closest point in the landscape to the observer. The view direction 
is given by a compass angle (CA), a “vertical angle” (VA) which is the angle below the horizontal of the 
observer’s line of sight. An optional tilt of the camera relative to the horizontal is given as a “bank angle” 
(BA) measured clockwise around the line of sight. 

In the Target mode, the horizontal position of the observer is specified by Cartesian coordinates X and 
Y, with X increasing to the right (North) and Y increasing to the top (West) of the screen. The Z and RZ 
values are the same as in the Angles mode. The view direction is given by a “Target” position in Cartesian 
X, Y, Z coordinates. In this mode, the horizontal position of the target is shown on the map by a red “X.” 


Graphical camera position 


If the view you’d like to define is within or close to the window’s confines, you can set up your 
picture simply and graphically with the mouse. First, click in the Map Window with the left mousebutton to 
put the program into ‘View Selection’ mode. As you move the mouse over the screen, the display for x,y 
position in the landscape and the height of the landscape at that point is continuously updated. The program 
also displays the number of the lake (or “Sea” if over the sea), if any, at that position in the landscape, and 
the £j labels of the point at that position (The integers i and j identify individual points in the landscape. 
More about these in the technical sections). When you click the left mousebutton a second time, the observer 
is fixed at that location. In Angles mode, dragging the mouse with the left mousebutton held down changes 
the horizontal view direction as indicated by the red field-of-view lines or moves the View Target if you are 
in Target mode. Notice that you can place the observer anywhere on the screen, even outside the Map 
Window (except on one of the buttons or string gadgets). 

In Angles mode the view direction stays the same as the observer is moved, while in Target mode the 
target remains fixed so the view direction changes to keep the target centered in the field of view. 

If you activate the Relative Height string gadget, press <RETURN>, and then move the observer, 
notice that the relative height of the observer stays the same while the absolute height changes with the 
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elevation of the landscape directly under the observer. This makes it easy to position the observer just above 
ground level, ft you like, or to pretend you’re in a fighter plane equipped with ground avoidance radar. Click 
the Absolute Height string gadget and press <RETURN> to go back to the default mode, in which the 
absolute height of the observer is fixed as the observer moves around the map. 


Graphical camera height 


The operations so far adjust the position of the camera and its target over the landscape. Its height and 
the height of the target above the landscape cannot be displayed in the Map Window’s two-dimensional 
perspective. To adjust the height parameters, you need a cross-sectional view. Panorama provides just that. 
Once the horizontal view is set, you can click the map with the right mousebutton, to show the observer’s 
vertical position and vertical view direction. The map is replaced by a profile view of the landscape. The 
same click and drag procedure with the left mousebutton sets the absolute observer height (click) and 
vertical view angle or view target (drag). The X,Y position of the mouse along a line through the observer 
position and parallel to the view direction and the landscape height Z at that point are shown at the top of the 
window, along with the height corresponding to the pointer position (PtrZ), and the current observer height 
(ObsZ). 

When you have the vertical positioning set to your liking, click the right mousebutton on the map part 
of the window to accept the new observer and view parameters and exit View Selection. 

At any time during View Selection you can press the <Esc> key to abort and restore the original 


observer position and view direction. If you don’t want to change the vertical positions, press the <Return> 
key during the first stage to exit. 


Sun position 


A yellow circle in the Map Window shows the sun’s horizontal direction from the center of the 
landscape. By default, the position of the sun is automatically adjusted as the camera’s view direction is 
changed so as to approximate the photographer’s ideal of side-lighting, which gives the relief of the 
landscape optimum definition. In making a series of pictures of the same landscape, allowing the position of 
the sun to change from one picture to the next forces recalculation of shadows and shading, which can add 
significantly to the rendering time at high Recursion Levels. So, you might want the sun fixed to a specific 
direction to save time. You can do this by selecting one of the six options in the ‘Sun Position’ submenu in 
the “View’ pulldown menu. The “Auto” option in the ‘Sun Position’ submenu will again free the sun 
position. 


Sun elevation 


In addition to the direction it’s coming from, sunshine also has an elevation angle, according to what 


‘time of day it is. In Panorama, the “Sun” defaults to being in the perfect photographically ideal place for a 


photo shoot all the time, no matter what time it really is, even if the sunshine comes from a nonsensical part 
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of the map. This ideal angle is 40 degrees--around 10 a.m. or around 2 p.m. most places of middle-latitude 
around the globe, The ‘Sun Elev Angle’ text gadget at the bottom of the Control Window permits you to 

— override the automation and establish this angle to suit yourself from -90 degrees to 270 degrees. It can also 
be changed in scripts which direct the creation of pictures for animations, hence the use of angles greater 
than 90 degrees to make it easy to set up a full sunrise to sunset sequence. A sun elevation greater than 90 
degrees means the actual horizontal direction to the sun will be opposite the nominal direction chosen in the 
‘Sun Position’ submenu and shown in the Map Window, and, of course, values less than 0 degrees or more 
than 180 degrees will put the landscape entirely in shadow, except perhaps for a few mountaintops. 


Camera lens 


The “Auto” option in the ‘Camera Lens’ submenu of the ‘View’ menu allows the camera focal length 
and vertical view angle to adjust automatically as the apparent angular size of the landscape varies with the 
camera position. This is mainly useful for giving an optimal view of the whole landscape when the camera is 
well outside the landscape and aimed toward the center of the landscape. The camera focal length is not 
allowed to get less than 28mm in the AutoLens mode when the camera is close to or over the landscape. Any 
attempt to position the camera using the graphical View Selection mode will terminate the AutoLens option 
and fix the focal length at 28mm. 

— The camera’s focal length is indicated in a text gadget at the bottom of the Control Window, and you 
can change its value by entering a new number in the string gadget or by selecting one of several preset focal 
lengths from the “Camera Lens” submenu of the ‘View’ menu. Camera focal lengths are given in 
millimeters, just like real, 35mm cameras. On such cameras, a “normal”? lens would have a focal length of 
50mm. A 35mm lens is moderately wide-angle, and 70mm to 100mm are moderate telephotos. Anything 
below 30mm would be a superwide-angle lens, and lenses of 11mm to 16mm or so would be considered 
“fisheye” lenses in the photographic world. ; 

Panorama accurately renders perspective according to what lens focal length you specify, including 
the typical wide-angle distortion (enlarged foreground, receding background) of wide-angle views, and the 
crunched, flattened perspective of telephotos--just as with real cameras. 

— The field-of-view markings in the Map Window are updated whenever you make changes in the 
camera position or view direction or focal length by entering numbers in the text gadgets. 


= Sea level and such 


At the top of the screen are indications of the scope of your landscape. The “Min Z.” specification is 
— __ the height of the lowest point on the landscape--the Death Valley of your creation. Mount Everest is on the 
other side, ‘Max Z.’ If the difference between these is large, you might need a wide-angle lens to take it all 
in. These specs are only for your information. You can’t change them by clicking them. 
Sea level, on the other hand, is clickable and changeable. Atlantis revisited. By default, the sea level is 
Set equal to Min Z, and no sea is visible. Enter a larger number into the ‘Sea Level’ string gadget, and 
Panorama will figure out where the new shoreline would occur, and draw the effect of the change in the 


i 
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view window. Refer to the Min Z and Max Z values for guidance in acheiving the effect you want, whether 
it is a bay pushing partway up a river valley or only a few mountain tops poking above the sea as islands. 


The righthand side 


The column of buttons along the righthand side of the Control Window permit “tweaking” the 
features they describe (Clouds, Trees, etc.). You can choose among a few preset options for these things 
using the ‘Features’ and ‘Colors’ pulldown menus, but if you want to specify the nth degree of detail for the _ 
Trees, Clouds, Waves, etc., you’ll need to deal with the requesters brought up by the row of buttons on the 
right side of the Control Window. In truth, these buttons permit more than just a tweak or two. They bring up 
full-scale requesters that allow you to manipluate Panorama’s many drawing parameters in the most detailed 
manner possible. If you just want a fast vanilla, use the menus. On the other hand, if you want the ultimate 
control over something--or everything --use the buttons. 

We’ll come back to these requesters later on, and discuss in detail what they do and some of the 
effects you can achieve with them. 


The title bar 


Look to the title bar at the top of the window for information on the current status of the program. 
Most of the time this will tell you the current Recursion Level. If the Recursion Level is 0, no landscape 
exists. Otherwise, the higher the number the more finely the landscape is subdivided into triangles. a 


Braving a new world 


A very important feature of Panorama is that you can Create landscapes that suit you, or let the 
program make one up. The process of “sculpting” a landscape to your liking starts with creating the initial 
data, as in the opening tutorial. Let’s take a more detailed look at that process, now--and still come back to it 7 
again later to explore some other subtleties. 

To create a wholly new landscape to suit your imagination, select ‘New Landscape’ from the ‘Actions’ —_- 
menu. This will open a window asking for a “Seed for Random Numbers.” The value for the seed a 
determines the particular sequence of “random” numbers that will establish the wiggliness of the rivers and 
the heights of points in the landscape. If this is the first landscape you’ve created during the current session 
with Panorama, the default number in the box at the lower center of the window, will be 0, otherwise the 
seed for your previous landscape will appear. No matter what the number in the box, if you Click the button 
labeled ‘Timer,’ the seed will be a large number extracted by the program from the computer’s clock. 
Clicking on the button labeled ‘Old? will reuse the seed from the previous landscape, if one exists. 

To enter a specific new seed, type it into the text gadget. A cursor--a white rectangle--is present at the 
Tight end of the text gadget box when the window opens. Backspace to erase the old number, and type in the 
new one. Any integer between 1 and 2147483647 will do nicely. The look of the final landscape will depend 
a a ae 
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on the fractal parameters as much as on the seed, and some seeds will yield more interesting pictures than 
others, Develop your own list of “good” seeds, but for starters with the default fractal parameters you might 
try 577663900. Hit the <RETURN> key to make Panorama accept the new number. 

Clicking anywhere on the screen outside the string gadget will deactivate the string gadget; to 
reactivate it, Click it with the left mousebutton. 

After entering the seed, the seed requester window disappears and a second requester appears with the 
title “Spring Probability for Level 1.” The Spring Probability is the likelihood that a particular point in the 
landscape will act as a source for a river. The current (or default) value of the spring probability for Level 1 
is displayed in the string gadget for your consideration. 

Below the string gadget is a slider. You can change the Spring Probability either by typing a new 
number (between 0.0 and 1.0) into the string gadget or by dragging the “knob” (the shaded rectangle in the 
slider box) with the mouse. If you don’t wish to change anything, accept the default value by clicking ‘OK.’ 
This starts the landscape generation process. You can abort by clicking ‘CANCEL,’ which you might want to 
do if you forgot to make an intended adjustment to the fractal parameters before selecting ‘New Landscape.’ 

With ‘Spring Probability’ entered, Panorama calculates Recursion Level 1, at which the landscape 
consists of 19 points and 24 triangles. The resulting very crude landscape is then displayed as a simple 
wireframe. You have the option of changing the heights of any of the points in the landscape by dragging the 
point up or down with the mouse. A point which is a local minimum will have all its radiating wires colored 
blue. A local minimum at this stage will usually grow into a very large lake, which can take an extremely 
long time to fill at Recursion Levels 4 or 5. You may want to eliminate any local minimum by raising that 
point and/or by lowering one of its neighboring points, in order to avoid the large lake problem as you build 
the landscape through higher Recursion Levels. 

Click the “‘OLD” button to recall the Level 1 heights of the previous landscape. If there was no 
previous landscape, this button will be “ghosted.” Click “REDO” if, after making some changes to the 
heights, you want to recall the original heights and start over. Clicking “1/2” halves all the heights. When 
you’re ready to proceed, click ‘OK’ at the upper left. 

The next step is to place springs where you want them in the landscape. When you okay the heights, 
the same wireframe view of the landscape reappears, except than the heights are fixed, and you can add or 
delete springs and rivers from your baby landscape by clicking the mouse on appropriate places for them to 
start. As long as you kept the heights unchanged on the previous screen, the springs laid down during the 
creation of Level 1 will still be in effect, and the rivers they generated will be shown as blue wires. You can 
add additional springs and their associated rivers by clicking with the left mousebutton near a point that isn’t 
on an existing river. The spring will be accepted only if a neighboring point to the one you selected is lower, 
and if the line to the lowest neighboring point is not along the edge of the landscape. To erase all existing 
springs and rivers, click “REDO.” To put springs everywhere possible, click “ALL.” 

Springs can be, and by default are, added in creating higher Recursion levels, but the springs placed 
during this operation will permanently affect higher Recursion levels even if Spring Probability is put to 
zero. Also, the rivers from these ‘Level 1’ springs can be selected for rendering exclusive of all the springs 
and rivers created later. 


Click ‘OK? to confirm the Level 1 springs and return to the Control Window, which will display the 
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map of your newly born landscape. Note the new values of “Min Z”” and “Max Z.” above the map. A Max Z 
greater than about 1000.0 at this stage usually results in high, rugged mountains, while a value less than 
about 600.0 usually means a gentler, more hilly landscape (assuming default fractal parameters). 


Numerical Z input mode 


The graphical method of adjusting the initial heights just described is simple and intuitive, but does 
not allow fine adjustments of the heights. More precise control over the heights can be obtained by selecting 
the ‘Numerical’ from the ‘Z Input Mode’ submenu under ‘Switches’ before you start a ‘New Landscape.’ 
With Numerical mode, the points of the initial Level 1 landscape are represented as an array of text gadgets, 
rather than the wireframe network. The height of each point shows in its text input gadget. Enter any new 
values you wish. The ‘OLD’, ‘1/2’, and ‘REDO?’ buttons are still available and function in the same way as 
on the graphical height adjustment screen. Click ‘OK’ to proceed to the spring placement window, where the 
gadgets representing the points still show the heights and are now button gadgets. Any initial springs and 
rivers are shown with ghosted buttons colored blue. Place a new spring by clicking on an unghosted button. 
The spring is only accepted if there is a neighboring point with a lower elevation, and if the path to the 
neighbor is not along the edge of the landscape. If the spring is accepted, the button at the spring and the 
buttons along the path of the river flowing from it become ghosted and blue. As with graphical spring — 
placement, a ‘REDO’ button erases the springs to start over. The ‘OLD’ and ‘ALL’ buttons do the same as in 
graphical mode. Click ‘OK’ when ready to go on. 


More triangles, more 


A Level 1 landscape isn’t very interesting in its own right, but it is interesting for what it can become 
as the landscape gets divided into more and more, smaller and smaller triangles, as mountains acquire 
ridges, pinnacles, and Cliffs, and as rivers more and more intricately meander through the valleys. The 
fractal subdivision process which does this building is organized into stages called Recursion Levels. Going 
from one Recursion Level to the next, each triangle turns into nine triangles with edges shorter by a factor of - 
3. You can either increase the Recursion Level by one step each time, adjusting the fractal parameters 
controlling the evolution of the landscape at each Recursion Level, or you can make Panorama jump 
directly to a higher Recursion level using the existing pattern of fractal parameters. The “Up 1” item in the oa 
“Increase Level’’ submenu from the ‘Actions’ menu brings up a requester allowing you to adjust the Spring 
Probability. Then, once you press <RETURN?> or click “OK,” the program increases the Recursion Level 
by one step. 

You can also select “To 3,” “To 4,” or “To 5,” and Panorama will take it from there, but you won’t 
have the control over the fractal parameters for each intermediate level. For initial experimenting you will 
probably want to stop at Level 3 on an unaccelerated Amiga 500 or 2000, or perhaps at Level 4 on an Amiga 

_ 2500 or equivalent, in order to keep calculation and rendering times reasonably short. Also, until you better 
understand why you’d want to control the fractal parameters at every increase in Recursion level, there isn’t 


a 
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much need in doing them one at a time. 
When you change Recursion Levels, the map display is automatically updated to show how the 
landscape looks at the new level. 


Water, water, anywhere 


Once you are at a Recursion Level where you want to render the landscape, you should work down 
the ‘Actions’ menu and “Fill Lakes” and “Run Rivers.” If you draw a picture straightaway, all the rivers 
active during the last increase in Recursion Level will be drawn as a spider web of blue and white lines. This 
can be instructive if you’re interested in how the fractal process works, but it’s neither pictorially convincing 
nor aesthetically very pleasing. 

“Running” rivers gives them non-zero depth and width, allowing you to be selective about how many 
of the rivers will be visible. “Filling” lakes means that local depressions can be rendered as containing 
water. Moreover, “full” lakes act as sources of rivers, in addition to the springs. 

Fill the lakes first! Al\ rivers are erased when you choose the ‘Fill Lakes’ option. 

Upon selecting ‘Fill Lakes’ (for the first time), Panorama scans through the landscape to find all the 
hollows where water can collect. A window titled ‘Busy...’ tells how many rows of points are left to go. You 
can abort the operation anytime by clicking on the window’s Close gadget. After the initial scan is 
completed, a new window will pop up with ‘Filling lakes...’ in the title bar. In successive passes through the 
landscape, Panorama raises the water level in each lake. A lake becomes ‘full’ when the water level reaches 
the lowest point on its rim. Once all lakes are full except one, the height of the water level of the last 
remaining lake is also displayed in the window. If you want to terminate the filling process at any time 
(Perhaps you want to model a lake without a surface outlet, like Crater Lake in Oregon), click “EXIT” in 
the ‘Filling lakes’ window. The lake-filling process can be resumed from where you left off at any time by 
reselecting “Fill Lakes.” The window closes automatically when all the lakes are full, and the “Fill Lakes” 
menuitem becomes checked. 

“Full” lakes will be invisible in the Map Window until you “Run Rivers.” Only partially filled lakes 
are immediately visible on the map display and are automatically drawn as lakes when the picture is 
rendered. Click ‘EMPTY’ in the ‘Fill Lakes’ window if you want to get rid of all the lakes. 


Running rivers 


Selecting ‘Run Rivers’ from the ‘Actions’ menu brings up a requester titled “How Many Rivers?” 
which contains two string gadgets. The first one sets how many permanent springs are to be sources of rivers 
visible in the picture. The number you enter is the number of a Recursion Level, a number from 0 to the 
current Recursion Level. The number of permanent springs activated is the number created up through the 
Recursion Level you enter, and is 0 if you enter 0. When you enter the level number, by pressing 
<RETURN?>, the corresponding number of springs is indicated on the next line. Normally you will not want 
more rivers than those the Level 3 springs create. 

The second string gadget, which is automatically activated after you enter the level number, is where 
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you specify the number of full lakes that are to be sources of rivers. The only lakes visible will be these 
lakes, plus the partially filled lakes and the lakes which are activated because rivers run into them. The last 
lakes to have been filled, and therefore usually the largest full lakes, are chosen first. There can be hundreds 
to thousands of lakes at Recursion Levels 4 and 5, most of them very tiny, and to avoid the clutter of 
showing all these lakes and the corresponding rivers you will probably want to keep the number of “rivers 
from lakes” to no more than 20 or 30. Any changes you make to this number at a given Recursion Level are 
recalled as the default when you create the next landscape. 

Click ‘OK’ to accept the values displayed. Panorama will find the courses of all the rivers and how 
the width should vary with distance from the source of the river. The width to be displayed can be rescaled 
later by changing the River Depth parameter. Running the rivers takes only a few seconds, even for a Level 
5 landscape. The lakes and rivers that you activate will be shown in blue in the Map Window. You can redo 
the rivers and make more or fewer visible at any time. 


Roughen and smooth 


These operations allow you to tweak the small-scale roughness of the landscape. Adding random 

height fluctuations is often appropriate in dealing with DEM data of real landscapes, since the DEM data is 

_ Often unnaturally smoothed on small scales. On the other hand, you may want to smooth your landscape on 
small scales, either because a fractal landscape got a little out of hand, or because you want to reduce 
annoying numerical artifacts present in some DEM data. You have a choice of two versions of each 
operation in the ‘Roughen’ and ‘Smooth’ submenus. Either make a rather inconspicuous change by selecting 
‘Slightly,’ or a more substantial change (a factor of two larger in amplitude) by selecting ‘Moderately.’ These 
operations make a permanent change to the heights stored in memory, so you may want to preserve the old 
landscape first (‘Save Data’ from the ‘Actions’ menu). 

The Roughen operation adds a random fluctuation to the height of each point in the landscape that is 
not on an active river. There is a separate random seed for this operation, which by default is the same as the 
seed for basic landscape generation, but it can be altered using the Fractal requester. Successive applications 
of the operation produce the same pattern of height fluctuations, so two operations of Roughen/Slightly is 
equivalent to one operation of ‘Roughen/Moderately.’ 

The Smooth operation averages the height of each point with the heights of its nearest neighbors, 
weighting the neighbors’ heights less or more strongly in the two options. 


Hit the Switches 


A great variety of rendering options is accessible through the menus, ranging from such basic things 
as screen resolution and overscan to choices among preset versions of such special features as clouds and 
haze. Many of these options and a few of the most basic rendering parameters are briefly described here, 
with technical details and descriptions of the more complex rendering parameters that are accessible through 
_ the buttons on the righthand side of the Control Window deferred to later Chapters. 
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24-bit 


Standard Amiga rendering modes, especially those of Amiga models prior to the so-called “AGA” 
chipset, have a very limited palette, limited to 16 colors for high-res screens or 32 colors for low-res screens. 
Dithering can give the impression of many more colors, at the cost of loss of resolution. The state of the art 
— in computer graphics is 24-bit color, in which computer displays can have over 16 million colors, allowing 
perfectly smooth color gradations. Effects such as haze and fog, which depend on subtle variations in color, 
require such smooth gradations to be convincing. While a number of add-on display boards allow Amigas to 
display large-palette color screens, they require individualized software support. Rather than supporting all 
of these boards directly, Panorama gives you the option of creating a 24-bit color picture in memory, which 
can be saved as a 24-bit IFF (Interchange File Format) file. These large-palette IFF pictures can then be 
displayed on whatever board you have for the purpose, now or in the future. Most of the various color 
boards come with software which converts 24-bit IFF files to their special display format, and image 
processing programs such as ASDG’s Art Department Professional allow conversion of Amiga 24-bit IFF 
pictures to.a wide variety of formats, including most of the popular ones for IBM, Windows, Macintosh, 

—— Sun, and other computers. 

Storing 24-bit color data requires a lot of memory (over a megabyte for the larger screen sizes), so it is 
not Panorama’s default option. To enable 24-bit capability, select the “24-bit” item from the ‘Switches’ 
menu. This menuitem will be have a checkmark in front of it when 24-bit is on. You must do this before 
drawing a picture in order for the picture to be drawn in 24-bit mode as the Amiga screen display is 
rendered, but you can turn 24-bit mode on or off at any time. With “24-bit” on, the picture on the Amiga 
screen will still be a standard Amiga picture of 16 or 32 colors (even on “AGA” equipped Amigas), but 
when the drawing is finished you will have the option of saving the 24-bit IFF file from the ‘Project’? menu 
on the picture screen. If you’re planning to work with 24-bit files, don’t worry about the look of the 
Amiga-resolution picture. Often it’s very blocky and ugly, compared to the 24-bit file, or even compare to 
— the HAM picture you can generate from the picture screen’s pulldown menu. 

Those 24-bit files eat diskspace, too. Expect several hundred kilobytes per picture. To save space, and 
to give you a good idea of what the 24-bit picture will look like (since the Amiga-displayable picture is 
___ father poor by comparison), you also will have the option of converting the 24-bit picture to the Amigas’ 
special Hold-and-Modify (HAM) mode with 4096 dithered colors. To do so, select the “Convert To HAM” 
item from the picture screen’s ‘Project? menu. HAM pictures can be displayed on any Amiga, 

AGA-equipped or not, 

If you use Panorama’s special overscan drawing modes to create pictures bigger even than the normal 

Amiga overscan modes, the HAM conversion option will not be available on the picture screen. You can still 

use Art Department or some other image processing program to make the conversion to both HAM and an 
—-  Amiga-displayable resolution. 

The 24-bit picture contains all of the color information needed for conversion to virtually any other 
display mode on any computer, including the new special AGA modes, which are not directly supported in 
~~ this version of Panorama, and Targa and other special resolutions popular on other computers. 

Using image-processing software, you can even get pretty good Amiga 16-color renderings from the 
24-bit file that Panorama creates. These heavily dithered, 16-color pictures occupy considerably less disk 
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space than the 24-bit files. With ASDG’s Art Department Professional, for example, set ‘Dithering’ to 
“Floyd-Steinberg,” raise the “Gamma” in the ‘Balancing’ section by 6 to 15 units, select the overscan and 
resolution parameters you want, and hit ‘Execute’ to generate the picture. 

Panorama’s “24-bit” item in the Switches menu is a toggle, so select it again to turn off 24-bit and 
free the memory used for the 24-bit data. The 24-bit capability is only available with Panorama’s ‘Solid’ 
draw modes (explained next), so the “24-bit”” menuitem will be ghosted when a wireframe draw mode is in 
effect, and selecting a wireframe draw mode will automatically turn off 24-bit. 


Draw modes 


The “Draw Mode” submenu in the ‘Switches’ menu offers a choice between ‘Solid’ and ‘Wireframe’ 

pictures, and for the solid draw modes a choice of many screen resolutions, including “Custom,” in which 

you can choose whatever resolution you want, and have memory to support. 
In Panorama’s default “Solid Lo Lace” draw mode the program draws solid triangles on a 
low-resolution, interlaced screen. Solid triangles, of course, are filled with color, unlike the empty ones that 
the “Wireframe’ modes (and ‘Preview’) draw. The higher the resolution of the screen, the more detailed the Es 
picture can be. The “Solid Hi Lace” mode gives finer detail, but has fewer colors (16) available, and might 
not look as good as a lower resolution mode with a 32-color palette. The ‘Solid Lo-Res” mode is the same 
as “Solid Lo Lace,” except that it is on a lo-res, non-interlace screen with pixels twice as large in the 
vertical direction. The coarsened resolution may be perfectly acceptable in an animation, where the fact that 
the memory required to store a picture is half as large is a big advantage, and the viewer may not have the 
time to look at any one picture for long enough to really notice the coarseness. 

If you’re primarily interested in a 24-bit picture, note that the coloring of the 16-color or 32-color 
picture drawn on the monitor screen may differ quite a bit from that of the 24-bit picture being created in 
memory. The rendering and dithering schemes are rather different, and features such as haze and trees, 
which can only be done properly in the wider range of colors, will either be absent or rendered very =" 
schematically on the Amiga screen. 

Two wireframe drawing modes are provided. Of the two, ‘Wireframe HL gives the best looking 
pictures, but takes more time to render. “HL” means “hidden lines removed.” In the simple ‘Wireframe’ — 
mode, you can look through mountains to see the landscape behind them. In contrast to the ‘Preview’ 
pictures already mentioned, both of these wireframe modes are on a high-res interlace screen. The wireframe 
pictures are not ‘realistic,’ but the ‘Wireframe HL’ mode, in particular, can produce quite striking pictures at 
Recursion Levels 4 and 5. They have a “mathematical” look to them that is quite interesting. 


Overscan 


The top half of the ‘Overscan’ submenu offers various degrees of overscan for standard Amiga 
rendering modes, which are labeled by the size of the screen in pixels in a high-res, interlace draw mode. 
The actual width and/or height of the screen in pixels will be reduced by the appropriate factors of 2 in the 
other draw modes. The numbers displayed in the menu will depend on whether your Amiga is set up for an 
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NTSC (in the United States) or a PAL (in Europe) monitor. 


“None” - No overscan, standard screen size. The high-res, interlace screen is 640x400 (NT'SO©) or 
640x512 (PAL). 


“704x440” (NTSC) or “704x552” (PAL) - Just enough to hide the borders on a standard Amiga 
monitor. 

“704x480” (NTSC) or “704x566” (PAL) - The standard overscan dimensions in many Amiga paint 
and animation programs 

“736x482” (NTSC) or “736x566” (PAL) - The screen is as wide and as tall as it can be and have the 
entire picture actually be part of the video signal generated by the computer (on Amiga models numbered 
below 4000). 

“768x484” (NTSC) or “768x566” (PAL) - The pictures are full video width, though a strip along the 
right edge of the picture 32 pixels wide (in high-res) will normally be blanked out, due to limitations of the 
Amiga hardware. The full picture may be visible when displayed through a frame buffer, such as NewTek’s 
Video Toaster. 

“= WBench” - Makes the screen dimensions, after adjustment for the display mode, the same as the 
dimensions of your Workbench screen as set in Preferences under AmigaDos 2.0 or as set using the freely 
distributable program “MoreRows” under AmigaDOS 1.2 or 1.3. Under AmigaDOS 2.0 and higher, this 
option considers the visible portion of the Workbench according to the user’s “standard” overscan 
preferences. (AmigaDOS 3.0 calls this “graphics overscan.’’) 


More rendering modes 


The submenu for the pixel resolution of your rendered picture has a dividing line in it, below which 
the rendering modes are not really native Amiga ones, though the software (and the Amigas) are capable of 
rendering them. First on this list is a “VGA-friendly” one: 640x480 pixels. There are many variations of 
VGA; some in 16 colors, while some higher. However, this is the vanilla VGA pixel resolution, which is also 
supported by AmigaDOS 3.0 and AGA-equipped Amigas. The pictures from this part of the submenu are all 
in 24 bits, so if you want a picture destined for display on VGA cards, you'll need to convert to the correct 
palette depth using image processing software such as Art Department Professional. Drawing in 24-bit mode 
and then converting it gives you a better picture for your trouble, by the way. 

The next option is 800x600, standard “Super VGA.” This resolution is useful both for AGA Amigas 
and with certain non-Amiga displays. It’s about as high as pixel resolution can go on desktop computers 
(Amigas included) without requiring an expensive monitor. Again, consider the palette you’ ll need, (usually 
256 colors in this mode) and convert Panorama’s finished picture accordingly. 

The 1024x768 option is another magic number to some non-Amigas. It’s becoming popular as 
“Extended SuperVGA.” Most of the available displays capable of this resolution are limited to 16 colors. 
It’s going to take an Amiga with plentiful memory to draw this resolution in higher Recursion Levels. 

If you’ve gone shopping in this pulldown menu and still not found what you want, consider the very 
bottom selection: “Custom 24.” Choosing this item brings up a requester which permits choosing any 
arbitrary resolution up to 8000 by 8000 pixels. Needless to Say, you must have sufficient memory in your 
machine to support whatever you choose. You’ll need 192 megabytes of memory to store the 24-bit picture 
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data for a 8000x8000 picture. A mere nine-megabyte Amiga is capable of around 1600x1600 in 24 bits. 

You might still be able to draw a picture extravagantly wide or totally tall, if you’re willing to give up some 
of the opposite dimension. Entries in this “Custom 24” requester need not be ““square,”’ in any sense of the 
word. For example, you can have very wide “panoramas” of 1280x482 pixels. Or tall ones, or square if you 
choose. You can also use this requester to make pictures smaller than a normal Amiga screen resolution. The 
requester accepts a minimum width of 160 pixels, or a minimum height of 100 pixels. 


Custom Aspect Ratio 


In addition to defining a custom size, the ‘Custom 24’ requester permits applying a special aspect ratio 
to the picture size you’ve defined. Some display devices want a picture of 1:1 aspect ratio, for example. For 
use on VGA displays, enter 1.0. You might need to experiment with this parameter with a quick, 
low-resolution picture before you commit a major amount of time to drawing at the final resolution. 

Note that an item of the ‘Features’ pulldown menu permits you to establish the ‘Amiga Aspect Ratio.’ 
That parameter applies to the picture you-see on the screen; the important thing is that the ‘Custom 24’ 
Aspect Ratio adjustment applies independently to the 24-bit picture data, not to the Ami ga-resolution 
display. Remember, the program draws its 24-bit version of a picture into a chunk of memory, independent 
of the Amiga-resolution picture when ‘Custom 24’ is operating. The aspect ratio you enter should be equal to = 
the ratio of the pixel width to the pixel height for your final display medium, whether Amiga-based or 
otherwise. 

When you have a 24-bit overscan mode selected, at least part of the picture (as much as will fit 
starting at the upper left corner) is also drawn to the Amiga screen using the Amiga screen overscan as 
indicated in the top half of the submenu. If the adjusted Amiga aspect ratio differs appreciably from the 
24-bit aspect ratio, the Amiga picture will appear distorted. When you display the 24-bit one, however, the 
aspect ratio will match what you’ve set for Custom 24-bit Aspect Ratio, and if what you’ve set matches what 
the display hardware wants, the picture will look “normal,” not distorted. 

Note that the ‘Convert To HAM’ option is not available for specially sized 24-bit pictures. 


More on 24-bit pictures 


When drawing is finished, the full overscan picture can be stored to disk as an IFF fileeither 
Amiga-displayable or 24-bitregardless of what is visible on your monitor. 

If none of the options in the lower half of the ‘Overscan’ submenu is checked off, a 24-bit picture you 
draw will have the same pixel dimensions as the actual Amiga screen, using the Amiga Aspect Ratio (from me 
the ‘Features’ menu) for the 24-bit pixels. However, if you select one of the 24-bit overscan options in the 
bottom half of the Overscan submenu, the 24-bit picture will be created independently of the Amiga Solid 
Draw mode chosen. (You cannot create a 24-bit wireframe picture.) The picture will have the size in pixels 
you specify, without any rescaling, and the aspect ratio will be independent of the Amiga Aspect Ratio. 
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By default, the 24-bit aspect ratio is always 1.0. You can change it with a ‘24bitAspectRatio’ ARexx 
or Picture Script command. In addition, if you select the “Custom 24” item, you can set almost any width to 
height aspect ratio you like for the 24-bit picture. Selecting any item in the top half of the menu will restore 
the corresponding Amiga screen dimensions for 24-bit pictures. 


Show Contours 


The “Show Contours” submenu in the ‘Switches’ menu controls how many of the solid-draw-mode 
Contours will have distinct colors. In principle, each of the five Contours has a different color, as set in the 
‘Colors’ menu or the ‘Colors’ requester (see below). However, within a limited palette of 16 or even 32 
colors, it is difficult or impossible to do a good job of shading (representing brightness variations) on five 
separate Contours plus Cliffs plus water, waterfalis, and sky. (Not to mention trees, sheen, haze, and horizon 
colors.) This submenu allows you to choose which Contours will have their nominal colors, and which will 
be assigned the color of another Contour or the Cliff color. The items of the submenu are the labels of the 
Contours, with checkmarks which toggle on or off when you select the item. Each checked Contour will 
have its normal color. Any unchecked Contours above the highest checked Contour number will be assigned 
the Cliff color. Otherwise, each unchecked Contour will be assigned the color of the next higher checked 
Contour. The palette for normal Amiga rendering is then adjusted accordingly to give the best possible 
shading consistent with the number of checked Contours. These color assignments do NOT apply to 24-bit 
rendering. Any 24-bit picture created in memory will have the full range of colors as shown in the ‘Colors’ 
requester. They also do not apply to the wireframe draw modes. 

Somewhat more complicated color assignments are possible using the ‘ShowContour’ Picture Script 
or ARexx command, See Appendix F. 


Shading 


Another choice in the ‘Switches’ menu is the type of shading to be used. Shading doesn’t mean 
“shadows.” It means the method the program uses to represent the three-dimensional shape of the terrain. 
On a two-dimensional screen, the shading is the clue that conveys clues about the third dimension to your 
eye. The brightness of the surface of a landscape varies according to the angle it makes with the direction to 
the sun. Think of a nice, sunny day outdoors. Surfaces which face away from the sun are dark, and those 
which bounce light toward you from the sun are bright. A curved object might have a gradient of dark and 
light, as it curves from pointing away from the sun to pointing toward you. 

The choices in the ‘Shading Type’ submenu vary in how elaborately the actual mathematical 
construction of the landscape from triangular facets is disguised to give the illusion of smoothly rolling 
terrain. They also vary in the amount of memory necessary to store rendering information, as well as in the 
time required for the rendering, and in the ability to take advantage of some of the more elaborate rendering 
features such as fuzzy, dithered transitions between Contours and shadow blending. The default for this 
option is simple “Faceted” shading, which renders the fastest and requires the least amount of memory. It 
shades each triangle of the landscape as a flat surface with a uniform color, texture, and brightness. 
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Landscapes created with faceted shading look “squared-off,” and “blocky,” and not very realistic. Yet the 
default shading method is good for getting a relatively quick look at a landscape and the layout of the 
Contours before spending the time it takes to make a final rendering. 

The other shading types are different types of smooth shading, all of which apply various, special 
computer techniques to produce the illusion of smoothly curved surfaces for each triangle. “Gouraud” 
shading is where this smoothing process begins to get real. Gouraud is the name of the specific computer 
algorithm that does the trick. This option calculates the brightness at each point (vertex) of the landscape by 
taking an average over the orientations of the six surrounding triangles. It then determines the brightness of 
each rendered pixel within a triangle by interpolation from the calculated, averaged brightnesses at the 
triangle’s corners. This does a good job of hiding the triangle edges, but goes foo far in that it often smooths 
away much of the brightness variations from one triangle to the next. When Panorama renders in this mode, 
a brightness value is stored for each point in the landscape, and these values can be reused the next time the 
same landscape is rendered as long as the sun position and elevation angle haven’t changed. 

The “Best” shading option is truly the best. It calculates and stores the brightness at the center of each 
triangle as well as the brightness at each vertex, and goes through a much more complicated and precise 
interpolation procedure to determine the brightness variations within each triangle. The results can be 
spectacularly realistic, with each little bump and wiggle in the landscape standing out in suitable lighting. 
Some of the program’s more advanced rendering features, such as Contour interpolation and Contour 
dithering take effect only when you’ve selected “Best”’ shading. Since there are about twice as many 
triangles as vertices, storing the brightness information requires three times the memory required for 
Gouraud shading. Additional memory is used to keep track of Contour and Cliff information so that this also 
does not need to be recalculated for subsequent renderings. If you have the memory, and do not mind a 
moderate increase in rendering time, the “Best” option is definitely the way to go. 

The “Better” option is intermediate between Gouraud shading and “Best” shading. It requires no 
more memory for storage than Gouraud shading, but adds some of the additional shading detail of the 
“Best” option. The main problem is that the simpler interpolation procedure can give rise to artifacts which 
sometimes disturb the illusion of a smoothly rounded landscape. 


Where to shade 


Panorama \ets you choose where yo want shading to be used. When you select one of the smooth 
shading options, it is actually applied only for those landscape elements (Contours and Cliffs) that you have 
selected (i.e., are checkmarked) in the ‘Smoothing On’ submenu. Read this menu as “Smoothing On 
Contour 1,” for example. It turns smoothing on for what you select in the submenu. You can change these 
selections only if you’ve selected one of the smooth shading modes. Faceted shading is applied to any 
Contours that have no checkmark in this menu. By default, smoothing is on for all the Contours and the 
Cliffs. 

Contour and Cliff boundaries are forced to lie along triangle edges, giving a blocky appearance to the 
coloration of the landscape in Faceted shading. With any of the smooth shading types in effect, the Contour 
boundaries are interpolated across triangles, and Contour Dithering takes effect to blend contours together 
more or less gradually. 
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The first time you draw a picture of the landscape with any of the smooth shading types selected, the 
brightness at each vertex and Contour and Cliff index values are precalculated and stored in memory before 
rendering begins. These pre-calculations don’t need to be redone for subsequent pictures, unless you change 
a rendering parameter which affects the precalculated quantities. The observer position and view direction, 
camera focal length, contrast settings, etc., can be altered without necessitating a recalculation. You can also 
change the type of smooth shading. 

Whether or not smoothing is on for a contour or cliffs, contour and cliff dithering will be in effect as 
Jong as the basic shading type is not “Faceted.” Selecting the “Faceted” shading type frees the memory 
storage area for both the vertex brightness values and the Contour/Cliff index valuesmeaning you’ll have to 
recalculate all of it, if you switch back to a smooth shading type. 


The ‘Features’ menu 


A few of the most basic rendering parameters are accessible individually from the ‘Features’ menu. 
Otherwise, this menu offers choices between various preset “packages” of rendering parameters dealing 
with particular features of the landscape, such as Contours, trees, Waves, and clouds. You can also, for each 
landscape feature, select “From File” in the appropriate submenu, in order to load that particular feature 
only from a Panorama “Settings” file. When you select “From File,” pick a “Settings” file using the file 
requester that appears, and Panorama will load new values for the parameters and settings appropriate to 
that landscape feature, leaving everything else unchanged. For instance, you can recall the ‘Cloud’ settings 
that gave a particularly interesting cloud pattern for some previous landscape without disturbing the Contour 
and observer position that you’ve selected for your current landscape. In this way, you can combine 
parameters for different features from a variety of tests (or successful results) that you conduct. Where there 
is an element of randomness in making the landscape feature, as with trees, waves, and clouds, the random 
seed is stored separately for each feature and is recalled from the “Settings” file along with the actual 
parameters. The ‘Color’ Settings for the landscape features are not changed by anything you do (or load 
from files) with the ‘Features’ menu. To change the colors, use the ‘Colors’ menu or the ‘Colors’ requester. 

Here is a brief discussion of the items in the ‘Features’ menu. Remember, this menu offers some basic 
maniuplations and presets of pre-packaged goods, and the ability to load from files. More intricate control of 
all of the individual features of the landscape is provided by the row of buttons down the right side of the 
Panorama screen. 


‘Vertical Scale’ 


Rescale all the heights in the landscape. Increase the vertical relief to make towering mountains or 
reduce it so the whole landscape is a nearly flat plain. Your choice, with the ‘Vertical Scale’ item. Rescaling 
preserves lakes and rivers, and Contour boundaries are scaled along with the heights, but the portion of the 
landscape treated as Cliffs will change as slopes become steeper or less steep than the ‘Cliff Slope Angle.’ 
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Select the “Vertical Scale’ item in the ‘Features’ menu, and use the slider (or type a new value) to adjust the 
Vertical Scale parameter in the requester that appears. The default value is 2000.0, which usually gives a 
moderately rugged landscape with default fractal parameters. Changing the Vertical Scale is reversible, even 
after increasing the Recursion Level, so it makes no difference whether you set the Vertical Scale at 
Recursion Level 1 or at Recursion Level 5. 

If you’ve already drawn a picture, changing the Vertical Scale will force recalculation of brightness 
values, Contour/Cliff values, and shadows, however. 


*Sea Level’ 


This menuitem sets Sea Level, but it presents it as a fraction of the height range from the lowest 
elevation to the highest elevation in the landscape, rather than as an absolute elevation. In other words, you 
don’t have to type a number, as with the text gadget in the Control Window. The requester that appears lets 
you choose a value for ‘Relative Sea Level.’ A value of 0.0 or less means no part of the landscape will be 


covered with “sea,” while a value of 1.0 or greater means the whole landscape will give Atlantis a run for its 
money--i.e., under water. 


‘Rivers’ 


Two parameters affecting the appearance of the rivers can be changed with the ‘Rivers’ submenu. 

The River Depth parameter controls the width of the rivers. The value of the parameter is the 
maximum “depth” attained by a long river. The width varies with distance from the source of the river and _ 
with the steepness of the river banks. The default value varies with Recursion Level, becoming smaller as 
the Recursion Level increases and the size of the landscape triangles decreases. 

The ‘Waterfall Slope’ parameter is the slope above which a river segment is drawn entirely in the — 
waterfall color. A river segment with a slope less than 0.2 times the waterfall slope is drawn entirely in the 
water color. The two colors are dithered together at intermediate slopes. The smaller the value of the 
‘Waterfall Slope’ the more rivers that will be colored as waterfalls. The default value is 0.3. 

This rather technical explanation means, in simple language, that rivers that flow over steep slopes 
become waterfalls, just as it is in Nature. The ‘Waterfall Slope’ parameter lets you control how steep a 
river’s path has to be before the program treats it as a waterfall. Ne that you also have independent control 
over the colors assigned for waterfalls and rivers. 


‘Contrast’ 


Dramatically enhance shading by increasing the ‘Sun Contrast’ parameter, or reduce it to get more 
subdued lighting, like on a cloudy day. Darken or lighten shadows with the ‘Shadow Contrast’ parameter. 
These effects are fully realized only in 24-bit pictures drawn with the ‘Best’ shading mode in effect. = 
' Remember, you can display an approximation of the 24-bit picture on your Amiga screen using the ‘Convert 
To HAM’ option in the picture screen’s pulldown menus. 
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To examine or change the ‘Sun Contrast’ parameter, select the ‘In Sun’ item of the ‘Contrast’ 
submenu. The default value is 0.5. Larger values increase the brightness of highlights where the sun’s rays 
are close to perpendicular to the slope of the landscape, and reduce the brightness and enhance the 
brightness variations where the sun is just grazing the landscape. The haze, cloud, and sky colors are 
brightened. At the maximum value of 1.0 the shading is no longer “realistic” but can have striking dramatic 
effect. When the maximum among the r, g, b values for the key color of a landscape element is close to 255, 
as it might be for “snow,” for instance, the brightness range is reduced, so the landscape element is seen as 
bright even where the sun is not face-on. Smaller values for ‘Sun Contrast’ reduce both the brightness 
contrast and the average brightness, until at the minimum value of 0.0 everything in sun has the same 


_ brightness, about three-fourths of the brightness of the key color. 


To access the ‘Shadow Contrast’ parameter, select the ‘Shadow’ item of the ‘Contrast’ submenu. This 
also can have values from 0.0 to 1.0, and 1.0 minus the ‘Shadow Contrast’ is just the ratio of the brightness 
of the shadow color to the brightness in sun when the sun’s rays are tangent to the landscape surface. The 
default “Shadow Contrast’ is 0.1. Larger values give darker shadows. When ‘Sun Contrast’ is large, the 
shadows will be almost completely black unless the ‘Shadow Contrast’ is close to zero. 


Contours 


A landscape can be rendered with up to five Contours, with their boundaries depending on the 
steepness and curvature of the landscape surface as well as height. Variable amounts of dithering can mix 
together the Contour colors on a pixel-by-pixel basis. All of this can be adjusted separately for each Contour 
boundary, and effects such as texture and shadow blending can be adjusted separately for each Contour. You 
have control over all these attributes in the requester called up by clicking on the Contours button on the 
righthand side of the Control Window, as discussed later on. What can be accomplished in the Contours 
submenu is much more limited, but easier to understand and operate. 

This menu also permits loading Contour information from a “Settings” file. Select ‘From File’ to load 
just the Contour settings from any Settings file. You can restore default Contour settings by selecting 
‘Default.’ = 

The ‘Beach’ option adjusts the top of the lowest Contour to be just slightly above sea level, and 


adjusts some of the other Contour parameters to give a fairly sharp upper boundary to the lowest Contour at 
a fairly uniform elevation. If you also select the ‘Beach’ item in the ‘Cliffs’ submenu, the result is rather 
natural-looking beaches on the more gently sloping parts of the shoreline. Of course, before making these 


"menu selections you should arrange the sea level to get a substantial amount of shoreline in the landscape. 


Also, be sure the color of Contour 1 is appropriate for a beach. 


Cliffs 


The menu options for ‘Cliffs’ are the same as for Contours. Load the Cliff parameters only from a 
“Settings” file, restore the default values of the Cliff parameters, or set the Cliff parameters specific to 
Contour 1 to make Contour 1 act as a beach. 
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Trees = 


Use the ‘Trees’ submenu to load only tree parameters from a “Settings” file (‘From File’), or to 
restore the default tree parameters, or as a Separate toggle turn the trees on and off with the ‘On’ item. Trees a 
are On when this last item is checked and when 24-bit rendering is enabled. Trees are rendered only 
schematically in normal Amiga rendering, using just one color which usually will not correspond very well 
to the tree leaf color chosen in the ‘Colors’ definition process. The correct tree colors will be visible on your ae 
Amiga screen if you use ‘Convert To HAM’ after the Amiga rendering is finished. They look even better if 


you can display the whole, real 24-bit picture using a special color board. The HAM conversion cannot 
preserve all the fine detail in the trees. 


Water 


The ‘Water’ submenu allows you to set four toggles dealing with rendering of water in rivers and 
lakes and/or as sea. You can turn off shadows for water (on rivers and lakes only) and/or turn off shadows 
for waterfalls. This allows making rivers or just the waterfall portions of rivers into glowing lava, though of 
Course you must also change the water and waterfall colors appropriately. 

With ‘Water Dither’ off, water in lakes will be drawn in the pure water key color in the sun (shadows 
will still exist if water shadows are on). A separate toggle allows the same to be true for the sea surface, 
Normally, with dither on, the water surfaces have brightness variations associated with texture, and an 
average brightness adjusted according to the elevation angle of the sun, and may have Sheen or Waves. 


Turning Water and/or Sea Dither off simplifies using compositing effects in programs like Art Department 
Professional, since you can use the water color as a mask. _ 


All four toggles are On (checkmarks present) by default. 


Waves — 


You can load Wave parameters from a “Settings” file using the ‘From File’ menuitem. This item will 
be checked once you have done SO, as a reminder. The checkmark is erased if you subsequently make any ce 
changes to the Wave parameters by selecting one of the other items in the submenu or by making any 
Changes in the ‘Wave’ requester. Again, loading this parameter from a file does not affect any other 
parameters you’ve set up. 


The last three items in the submenu allow a choice between having no variations in water brightness 
(‘Off’), having ‘Sheen’ on, or having ‘Waves’ on. With ‘Sheen’ there are variations in water brightness and 
texture on scales of several triangles edge lengths. Rendering is not slowed down very much. With ‘Waves’ 
a serious attempt is made to simulate a rippled water surface. The characteristic size of the Waves can be 
much smaller than a landscape triangle, and they can be customized in a variety of different ways. 
Rendering time can increase greatly if water surfaces close to the camera take up a substantial portion of the 
picture. Control over the Waves and the amplitude of the Sheen is through the ‘Waves’ requester. 7 
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Ground plane 


A ground plane can be used to extend the landscape beyond the region for which height data is 
available, giving a true horizon. The menu gives you a choice between no ground plane (‘Off’), a ground 
plane at sea level with the sea color (‘Sea’), a ‘Land’ ground plane at the lowest elevation in the landscape 
and with the color of the lowest Contour which is selected in the ‘Show Contour’ submenu under the 
‘Switches’ menu, or a ‘Custom’ ground plane, which in 24-bit rendering is givén the custom ground plane 
color set by the ‘Colors’ requester and in Amiga rendering is treated as a ‘Land’ ground plane. With a ‘Sea’ 
ground plane and ‘Waves’ on, the Waves are drawn on the ground plane as well as on the part of the sea over 
the landscape proper (in 24-bit rendering only). 

The ‘Ground Plane’ option works best when the camiera position is carefully chosen so that part of the 
horizon line is hidden behind mountains or hills. Particularly nice effects are possible with the ‘Sea’ option 
selected for ‘Ground Plane,’ when the camera is pointed down a partially drowned river valley. 


Haze 


Choose between loading the haze parameters (only) from a “Settings” file (“From File’) or one of 
four preset haze types. The preset haze types are the default, ‘Thin Haze,’ which puts the top of the haze 
above the camera with a haze density which only slightly obscures things over a path length equal to the 
diameter of the landscape, ‘Thick Haze’ which increases the haze density to give fairly heavy obscuration 
when looking all the way across the landscape, “Thin Fog’ which puts the top of the haze about halfway 
between the lowest elevations in the landscape and the camera height and a large enough density to give the 
impression of a ‘mist’ filling the valleys, and finally “Thick Fog’ which sets the haze height in the same way 
as “Thin Fog’ but makes the haze density quite large, so not very much is visible below the top of the fog. 

All haze effects are visible only in 24-bit rendering. 

The last item in the Haze submenu, ‘On,’ toggles haze on (checked) and off (unchecked). Additional 
and more elaborate haze control, as with the other features, is provided from the ‘Haze’ button. 


Sky horizon 


In 24-bit rendering the sky near the horizon can be a different color than the sky near the zenith, with 
a smooth interpolation of color between the two limits. The horizon color and sky zenith color can be set in 
the ‘Colors’ requester. The Sky Horizon submenu lets you load settings for the ‘Horizon Height’ and the type 
of color interpolation from a Settings file (‘From File’), or set directly the type of color interpolation. Select 
“Off,’ and the sky will be entirely in the sky zenith color; select ‘RGB’ (the default) and the color 
interpolation will be in RGB color space, going, say, from yellow to a pure blue through shades of grey; 
select ‘HLS/RGB?’ and the interpolation is done in a special variant of Hue-Luminosity-Saturation color 
space, with the hue interpolation going around the color wheel from red to green to blue, and the last 
“HLS/RBG?’ differs only in that the hue interpolation is in the opposite sense (red to blue through purple). If 
all this seems like Greek to you, just give the different options a try. Be sure to turn 24-bit on, and ‘Convert 
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To HAM?’ after the picture is finished. 
Clouds | ies 


Dramatic cloudscapes can be added to your landscapes in Panorama, and with a great deal of user 
control over how the clouds will look. In the ‘Clouds’ submenu, either load the cloud parameters ‘From — 
File,’ restore the ‘Default’ cloud parameters, or pick one of two other preset combinations of cloud 
parameters giving wispy ‘Cirrus’ clouds or smaller, more compact ‘Cumulus’ ones. The ‘On’ menuitem turns 
Clouds on or off (The checkmark is present when cloouds are On). Clouds are visible in normal Amiga 
rendering. However, they look many times better in 24-bit pictures, which provides enough colors to render 
their subtleties to a “tee.”” Panorama’s clouds look three-dimensional, something it’s not possible to.render 
properly in a 16-color Amiga display. In 24-bit pictures, the clouds are also subtly blended at their edges into 
the sky, and they exhibit color gradations where they’re thicker or thinner, to show their dimensionality. 


Max distance 


When this parameter is set to a value greater than zero, any parts of the landscape greater than this 
distance from the camera will not be drawn. This option offers the possibility of speeding up rendering when 
you know that the more distant parts of the landscape will be hidden behind a mountain. 


Resolution 


There isn’t much use in drawing individual triangles when the projected sizes of the triangles on the 
screen would be less than one pixel across. The ‘Resolution’ parameter controls how small, relative to the 
pixel width, the landscape triangles are allowed to get on the screen. The more distant parts of the landscape 
are drawn coarser by a factor of 2 in linear dimensionsthat’s a factor of 4 in area. The smaller the vatue of 
the ‘Resolution’ parameter, the closer in this coarsening of resolution takes effect. At the default value, 1.2, 
the coarsening takes effect when the projected width of a triangle is less than about 1.5 times the pixel width.  — 
For an observer looking across a Level 5, low-res, non-overscan landscape, with a 28 mm lens, roughly the 
most distant third of the landscape would have its resolution coarsened. Switching to overscan, changing toa 
high-res draw mode, or increasing the lens’ focal length reduces the amount of coarsened resolution in the — 
landscape. Decreasing the “Resolution” parameter may help reduce objectionable flicker due to “pixel 
crawl” in Level 5 animations, by making the average number of pixels per triangle larger. No rivers are 
drawn in the part of the landscape affected by the coarsened resolution, and the shadows are not always 
correct in detail. The coarsened part is drawn 3 to 4 times faster. 


Aspect ratio 


Set the Amiga Aspect Ratio, that is, how the width and height of the field of view of the camera 
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should relate to the width and height of the Amiga screen in pixels. 
You can adjust the drawing in Panorama for the aspect ratio of your monitor, or to accomodate a 
... Particular frame buffer or other picture display device--perhaps for pictures to be exported for display on 
non-Amigas. The default Amiga Aspect Ratio--0.846--is displayed when the requester pops up. This is 
approximately the aspect ratio for the “normal” Amiga display. This parameter is also controllable using the 
*AmigaAspectRatio n.nn’ command in a “Settings” file. 

Normally, the value of the ‘AmigaAspectRatio’ parameter should be equal to the ratio of the pixel 
width to the pixel height on your monitor when either a low-res, non-interlace or a high-res, interlace screen 
is displayed. This ratio varies slightly among various models of Amiga monitors. It also varies on some 
monitors with user-tuneable picture height and width. 

You can check the aspect ratio of your monitor by drawing a rectangle on a low-res, non-interlace 
screen using a paint program which displays screen coordinates for the mouse position. Find the ratio of the 
— height to the width (in pixels) for which the rectangle looks square on the screen. This is the aspect ratio. 

As discussed previously, Panorama provides a separate ‘24bitAspectRatio’ which is used for 24bit 
pictures sized independently of the Amiga display, and which can be set with a “Settings” file or with 
..  ARexx commandsor entered in the ‘Custom 24’ requester used to set 24-bit screen dimensions. 


Harnessing the Rainbow: the ‘Colors’ menu 


‘The ‘Colors’ menu is for making “quick and dirty” color selections, primarily for the Contour and 
Cliff colors, and for restoring colors to their default values. The ‘Custom’ menuitem calls up the same 
“Colors’ requester you get by clicking ‘Colors’ on the righthand side of the Control Window. A ‘From File’ 
item lets you load just the ‘Colors’ settings for all of the landscape elements. 

Select the appropriate item in the ‘Default’ submenu to restore the default colors. All of the landscape 
elements not associated with Contours and Cliffs are accessible here. 

There are individual submenus for each Contour and for the Cliffs, giving choices among a number of 
preset colors for the landscape surface, and separately for the trees associated with that Contour. What you 
actually set is a key color, from which Panorama generates a whole range of colors of different brightnesses 
— with which to produce shading and shadows. The Contour preset colors are called ‘Yellows’ (for sand, either 
a beach or a desert), ‘Browns’ (for dirt or brown grass), ‘Bluegrns’ (for coniferous vegetation), ‘Lt Grays’ 
(for rock), “Whites” (for snow), and ‘Yelgrns’ (for deciduous vegetation). The first five of these colors are the 
default colors for the five Contours (the default color for a Contour is the item adjacent to the parent 
menuitem when you open the submenu), and ‘Lt Grays’ is the default color for the Cliffs. There is also a 
choice among three tree (leaf) colors for each Contour. ‘LGr’ and ‘Yel’ (light green and an orangy-yellow) 
are intended primarily for use with the ‘Oak’ tree type, while DGr (dark blue-green) is intended for use with 
the ‘DFir’ and ‘AFir’ tree types. However, switching colors will not cause a switch in tree types and vice 
versa. The “DGr’ tree color is the same as the ‘Bluegrn’ Contour color, so if you turn on ‘DGr’ trees for a 
Contour with the ‘Bluegrn’ Contour color, you may want to change the Contour color (e.g., to ‘Yelgrn’). 

See ‘The menu checkmark indicating the choice of a preset color is erased when a custom Contour or tree 
color is defined for that Contour, or when you load a landscape Data file. 
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‘Colors’ Requester 


The ‘Colors’ requester allows you to set a 24-bit custom key color for any of the landscape elements. 
Call up the requester either by clicking with the left mousebutton when the mousepointer is over the 
‘Colors’ button at the right side of the Control Window, or by selecting ‘Custom’ from the ‘Colors’ menu. 
The requester displays all of the key colors in an arrangement which lets you see the colors juxtaposed much 
as they would be in an actual picture. The colors are stored as RGB values each ranging from 0 to 255. Of 
course, the standard Amiga display has a maximum of 16 levels of brightness for each of r, g, and b, which 
is 12-bit color rather than the 24-bit color used internally by Panorama. The colors displayed are the closest 
Amiga colors to the 24-bit colors, and small changes in the 24-bit colors will often not change the color 
shown in the requester. 

Pick the landscape element whose color you want to change by clicking on its part of the display (The 
mouse pointer must be not be over any text). The numbers 1-5 label the corresponding Contours, and the 
schematic tree images for each Contour and the Cliffs have an upper rectangle for the leaf color and a lower 
rectangle for the bark color. There are two cloud colors: the border around the edge is the ‘thin cloud’ color 
and the central part is the ‘thick cloud’ color. Also, note that there are separate regions and potentially 
separate key colors for the ‘Water’ color, which applies to rivers and lakes, and the ‘Sea’ color, which 
applies in 24-bit rendering to where the landscape is below sea level and to the sea ground plane. Only the 5 
Contour colors, the Cliff color, the sky color, the water color, and the waterfall (WFL) color are used in 
regular Amiga rendering. The other colors will only be used in 24-bit and HAM pictures. 

After you click on a color element, like sea or water, its r, g, b values are displayed in text gadgets at 
the center of the requester, and the sliders on the left adjust accordingly. If you move one of the sliders or 
enter a new value in one of the text gadgets, the new color is displayed in the appropriate region on the right 
so you can see how it looks in conjunction with the other colors (within the limits of the Amiga palette, as 
discussed previously). 

After you are finished adjusting the colors, click ‘OK’ to accept the new colors, or click ‘Cancel’ to 
restore the colors in effect when the requester opened. In either case, the requester closes and the Control 
Window is reactivated. Until you exit the requester, the Control Window’s menus and gadgets are frozen and 
unable to respond. 

Remember that the color you set for a landscape element is a key color, which Panorama uses to 
generate a whole range of colors for actual display in a picture. Depending on lighting conditions, 
particularly in 24-bit pictures which have haze and blending between horizon and sky colors, the key color 
may not be all that close to the dominant colors associated with the landscape element in a picture. 


Wireframe colors 


The descriptions above are valid when your picture drawing is selected for one of the Solid draw 
modes, as indicated in the ‘Draw Mode’ submenu under the ‘Switches’ menu. The management of color is 
. completely different when one of the wireframe draw modes is in effect. The ‘Colors’ menu reduces to three 
items, without any submenus. ‘Custom’ calls up a special wireframe ‘Colors’ requester, as does clicking on 
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the ‘Colors’ button at the right side of the Control Window. ‘From File’ loads wireframe color information 
from a “Settings” file. The wireframe sky, water, and Contour colors are completely independent of the 
Solid mode colors. The Contour 6 color is used for waterfalls and rapids. ‘Default’ restores the all of the 
wireframe colors to their default values. 

The requester used for wireframe custom colors has a row of buttons across the top of the window 
labelled ‘Sky,’ ‘Wat,’ and ‘C1’...‘C6’ for the six Contours. Click one of these buttons, and the corresponding 
color is shown in the box at the right side of the window and becomes the background color for the sliders. 
The RGB values are shown in the text gadgets. Move the sliders or enter new values in the text gadgets to 
change the color. Click on another of the top row gadgets to start working with a new landscape element. 
When ready to exit the requester, click ‘OK’ to accept all of the altered colors, or click ‘Cancel’ to go back to 
the colors that were in effect when the requester opened. 


Making and Saving Pictures 


First the Preview 


Check the framing of your picture before committing yourself to fullscale rendering by selecting 
“Draw Preview’ in the ‘Actions’ menu. The Preview is a simple wireframe picture drawn at the resolution of 
no more than a Recursion Level 3 landscape. The color of the “wire” corresponds roughly to the Contour 
color appropriate to the wire’s height in the landscape. It is blue when both ends of the wire are in the same 
lake or in the sea. 

To return to the Control Window, click in the Preview screen with either mousebutton, or press <Esc>. 
You need not wait for the Preview to complete its drawing. To proceed inne aiately with drawing the actual 
picture, press the <RETURN> key or the <D> key. 


Draw a picture 


‘Anytime you want to draw a Panorama picture, select ‘Draw Picture’ from the ‘Actions’ menu. 
Before the drawing begins, the program will do a bunch of calculating. How much calculation depends on 
the Shading ‘Type and Recursion Level chosen. The higher the Recursion Level, the more calculation (by 
about a factor of 9 for each increase in Recursion Level). Although it might seem interminable at Recursion 
Level 5, there is an advantage to all this pre-calculation. Once the program knows which points are in 
shadow and the like, it can construct views of the landscape from any angle and with a number of other 
items changed (like clouds), without recalculating the data. (Appendix C tells you in more detail what you 
can change without necessitating a recalculation.) 

While the program is performing its pre-calculations, the number of rows left to calculate is displayed 
in a “busy box” to let you know what progress has been made. If the ‘Shading Type’ you’ve selected is any 
of the smooth shading options, brightness values must also be computed and stored, following the 
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calculations for the shadows. Again, the number of rows left is displayed in the box named “‘Busy”to keep 
you informed. These brightness calculations proceed more slowly than the first batch. Once all calculations 
are finished, Panorama begins drawing the picture. You can abort the precalculation at any time by clicking 
on the ‘Close’ gadget of the little window displaying “‘rows left.” Once the actual drawing starts, you can 
abort, if you wish, by pressing <Esc>. If you’ve looked into other programs while Panorama was 
calculating, you might have to click in the picture window with the left mousebutton to make it active. Then 
<Esc> will abort the drawing process. 


The ARexx progress report window 


During the drawing process, if your Amiga is running ARexx, a small output window named 
“‘Rexx-Panorama” will be present on your Workbench screen. You can move it out of the way, or resize it to 
your liking, but you cannot close it. Panorama issues progress reports to this window through ARexx 
interprocess communication, letting you know what is being drawn (e.g., “Land triangles’”’) and how many 
rows (of triangles) are left to be drawn. 

This window is not present if ARexx is not running, or before Panorama begins drawing a picture. 
Panorama will not automatically fire up ARexx if it isn’t present when Panorama starts up. 


Drawing clouds 


After the landscape proper is drawn, and if Clouds or 24-bit rendering are On, the clouds and the 
24-bit sky and ground plane will be drawn. This may not be immediately apparent to you, since the 
background color for the Amiga screen is the sky color. Pressing <Esc> one time at this stage will stop the 
drawing process, leaving the picture screen open. When the picture is completely finished, the picture screen 
will “beep” (i-e., flash). In either case, a ‘Project’ menu and a ‘Colors’ menu are attached to the picture 
screen to give you the opportunity to do things with the picture. The picture has no titlebar, so you have to 
press (and hold) the right mousebutton to get the menu to appear. If you want to return to the Control 
Window, press <Esc> or select ‘Exit’ from the ‘Project’ menu on the picture screen. 


Adjusting colors 


You can use the picture screen’s menus to finetune the Amiga display colors right on the picture 
screen, where you can see the results of your changes instantly. With a Solid draw mode picture, the ‘Colors’ 
menu lets you change to one of the preset colors for any of the Contours or the Cliffs, like the ‘Colors’ menu 
for the Control Window, but without the tree color options. You can also choose between ‘Dark’ and ‘Light’ 
shadows in the ‘Shadows’ submenu. 


With a Wireframe picture a ‘Default’ menuitem restores the default wireframe colors. With either type 
of picture, selecting ‘Custom’ in the ‘Colors’ menu or pressing the <F3> key brings up a ‘Custom Color’ 
" requester. This lets you adjust the RGB values for any of the Contour colors, the sky color, the water color, 
and for Solid-mode pictures, the waterfall color and the Cliff color. Click the appropriate button at the top of 
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the requester to select the landscape element. After moving a slider or entering a RGB value in one of the 
text gadgets, all of the range of picture colors corresponding to the selected landscape element are changed 
- on the fly to reflect the new key color. Click ‘OK’ to exit the Be aa and accept the new colors, or click 
‘Cancel’ to restore the original colors. 
The color changes you make on the picture screen have no effect on 24-bit pictures in memory, but the 
new key colors will be remain in effect for the next picture (both Amiga and 24-bit versions) you draw, 
unless you do something to change them in the meantime. 


Picture centering 


With an overscan picture, you will notice the position of the picture shift on the screen when you first 
____ try to access the menus by pressing the right mousebutton. This brings the upper left corner of the picture to 
the same position as the upper left corner of your Workbench screen, so the menus will be fully visible. On 
the other hand, the picture should be properly centered to see as much as possible of the overscan regions at 
the right and bottom edges. The <F5> key acts as a toggle to shift the picture between its centered position 
and its menu-accessible position, and at the same time hide or show the mouse pointer. Panorama tries to 
make the default centering optimal, independent of the centering of the Workbench screen. 
Just how much of an overscan screen is visible can be quite sensitive to the centering. High-res 
— pictures are particularly delicate in this respect, in that incorrect positioning can blank out a wide strip on the 
righthand edge. The centering can be finetuned using the cursor arrow keys to slide the picture up and down, 
left and right. Start with the picture in its default centered position. The centering adjustment is stored and 
_. automatically recalled for subsequent pictures. 
The one exception to all this is the “=WBench” overscan mode. Centering adjustments can still be 
made for a given picture when the mousepointer is invisible, but the adjustments are not stored, and the 
picture opens with the centering of the Workbench screen. 


Hold picture 


If the “Hold Picture’ item in the picture screen’s ‘Project’ menu is selected (It will have a checkmark if 
it is.), the picture will remain in memory after you “Exit” the picture screen and return to the Panorama 
Control Window. The held picture can be toggled to the front and back with the <F5> key, and it can be 
saved to disk through the ‘Save Picture’ submenu from the Control Window. The picture screen menus are no 
longer available once you exit the picture screen, even though the picture can be made visible. If your Amiga 
is low on memory, avoid the ‘Hold Picture’ option. 


Blurring 


The “Blurring On’ item in the picture screen’s ‘Project’ menu is enabled (unghosted) only when there 
is a 24-bit picture in memory. Selecting this item toggles Blurring On and Off, as indicated by the 
checkmark. Blurring is a procedure applied to the 24-bit pixels when the 24-bit picture is converted to HAM 
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or saved to disk. The colors of neighboring pixels are mixed together to give an antialiasing effect, and to 
soften sharp contrasts in color. The 24-bit picture in memory is not altered, and you can you save a picture 
with Blurring off, after you have saved one with blurring turned on. 


HAM conversion 


The Amigas’ Hold-and-Modify, “HAM” graphics mode allows 4096 colors to be on the screen at 
once. A number of Amiga paint programs such as DeluxePaint 4.0 and above, Spectracolor, and Digi-Paint 3 
are designed to work quite well in this mode. The HAM picture mode is particularly useful if you wish to 
combine one of Panorama’s pictures with other picture elements--a bird or an airplane, for example--in a 
paint program. 

Panorama offers a sophisticated HAM generation option, which is optimized to avoid fringing and 
preserve the dithered textures of Panorama’s landscapes, while also using dithering to give the impression 
of smooth 24-bit color gradations where appropriate. HAM conversion requires the presence of 24-bit 
picture data in memory, so be sure the ‘24-Bit’ item in the ‘Switches’ menu is checkmarked before you start 
drawing the picture. The picture can be in any of the Solid draw modes, either low-res or high-res, though 
the final HAM screen will be low-res (a limit of the Amiga display hardware). There is some loss of detail 
from the 24-bit picture, but the results are often remarkably effective. All of the elements of the landscape 
can have separate key colors while keeping the full range of smooth shading brightness variations. 

To create an Amiga HAM picture, select ‘Convert To HAM’ from the ‘Project’ menu on the picture 
screen. If this menuitem is ghosted, the 24-bit data is not available. There will be a pause while the picture is 
analyzed, and then the picture will be redrawn in HAM mode. 

Once you change a picture to HAM mode you can no longer change the colors in the picture with the 
‘Colors’ menu, which will be ghosted out. The original 16- or 32-color Amiga display is not preserved, 
either. The HAM picture can be saved in the same way as a regular picture. Select ‘Save/Amiga ILBM’ from 
the pulldown menu on the picture screen (or from the Control Window if ‘Hold Picture’ is in effect). 

HAM conversion can also be performed as part of a Picture Script or with ARexx commands. 


Saving pictures 


The ‘Save Picture’ submenu lets you save either the current Amiga picture as a standard ILBM file or, 
if available in memory, the 24-bit picture data as a 24-bit IFF file. The size of a 24-bit IFF file can be quite 
large, about 350K to 400K for a low-res 352x440 picture and twice that size for a hi-res picture, or even 
larger with greater degrees of overscan. If you’re using the ‘Custom 24’ options, you might be shocked at 
the size of the files generated. Forget floppydisks for storing these. They probably won’t fit, unless you have 
a landscape with very little variation in it. 


Settings Files 


A “Settings” file is a listing on disk of information about the rendering modes, observer position and 
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view direction, camera field of view, sun direction, sea level, Contour heights and colors, etc., plus the color 

definitions and other parameters you can adjust in Panorama’s user interface. The program lets you save 

“Settings” so you can take up where you left off, if you need to, or re-generate a picture from an earlier 

session with the program. 

Create a “Settings” file either before or after drawing a picture, by selecting ‘Save Settings’ from the 
‘Actions’ menu. Given the same landscape data to work on, you can later recreate substantially the same 
picture, if you want, or apply any changes, render to a different resolution, etc. The “Settings” file 
complements (but partially overlaps) the information in a Panorama Data file. 

a A “Settings” file is all text, and can be edited or inspected with any text editor. A few entries are not 
accessible from the program’s graphical user interface. The “Settings” commands are a subset of the 
“Picture Script’ commands, which control animation. 

= On disks, a “Settings” file is distinguished by the filename extension ‘set,’ and should not contain 

any commands to draw or save pictures. You should save a “Settings” file anytime you want to record an 

observer position, custom colors, etc., for later reference. A “Settings” file is only a few hundred bytes in 
size So you Can save many of them on a single disk. Some example “‘Settings”’ files are in the Settings 
drawer on the Panorama program disk. 

To load a “Settings” file, select ‘Load Settings’ in the ‘Actions’ menu. Only files with the “set” 
extension will be shown in the file requester. Click the file you want, and then click ‘OK!’. A “Settings” file 
— with the special name “PanoramaConfig.set” can be used to define your own custom default settings. If it is 

present, it will be automatically loaded when Panorama starts up. The “PanoramaConfig.set” file must be 

either in the same directory from which you run Panorama or in the “s:” directory of your system disk 

__ _ (That’s the one you booted the computer on). The “s:” directory holds your startup-sequence file and other 
configuration and startup files. Panorama looks in the current directory first, Be sure to retain the original 
Panorama disk in its untouched form, so you can restore the “PanoramaConfig.set” file if you get things 
messed up and wish to revert to ‘factory’ defaults. 


End of Tour. Whew! 


It’s been a while since we set out on this “tour” of Panorama, but this is it, time to buy more popcorn, 
Stock up on doughnuts, and get down to playing with the program for serious. Do take some time to examine 
the elements mentioned before going on. Extensive as it is, the information imparted so far only scratches 
the surface of what the program can do, of its many, many user choices, and of its fractal capabilities. This 
covers the basics, though--the basic operations of Panorama, with explanations added where possible. Yet, 
— the real power of the program is yet unexplored in these pages. Everything that follows builds on--and 
complicates--what has been discussed up to now. 
Before digging into to the rest of this manual, therefore, please spend some time just “looking 
_ around,” getting the feel for its features, and learning where to look for things. From here on, the description 
of the more advanced features will be less tutorial, and more reference-oriented, If you get stuck, check into 
the “Troubleshooting” section (see the Table of Contents) for guidance. 


i 
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- SECTION IV: 


- ‘Designing’ Fractal Landscapes 


Fractal tinkering 


Panorama gives you much more control over the process by which it generates fractal landscapes than 

any similar program. You have five numerical parameters and four On/Off switches which can be changed at 
—— each Recursion Level, as well as options at each Recursion Level of rescaling heights and deciding which 
rivers will play a role in molding the landscape. The interplay between the evolution of the fractal river 
network and landscape proper adds a whole new dimension to the theory and practice of fractal landscapes. 
Rather than just a black box into which you plug a random seed, Panorama lets you get right in and tinker 
with the machinery of its fractal landscape generator. The result is an enormously more varied and intriguing 
range of possible new worlds. 

Four of the fractal parameters for the current Recursion Level are accessible through the ‘Fractal’ 
requester called up by clicking on the ‘Fractal’ button at the top of the column of buttons at the right side of 
the Control Window. The remaining parameter, the ‘Spring Probability,’ is so important that you are 
presented with a requester showing the current value and giving you the opportunity to change it whenever 
— you select the “By 1” option for increasing the Recursion Level. The On/Off switches can be toggled with 
menuitems in the ‘Fractal’ menu; a checkmark indicates the switch is ‘On’. Both parameters and switches 
can also be changed using ARexx commands, either from an ARexx macro program or by entering them 
directly in the ARexx Command window called up by selecting the ‘ARexx Commmand’ item in the 
‘Actions’ menu. While the nitty gritty of what the parameters and switches do is described in this Chapter, 
you are encouraged to get a better understanding of the overall fractal generation process and the basic 
algorithms involved by reading the “About Fractals” chapter, even though some of the mathematics there 
may be heavy going. ° 

For a fractal purist, the parameters and switches should be set before Starting a new landscape and left 
unaltered as the Recursion Level is increased. However, you might come closer to model ing the real world if 
you modify at least some of the parameters as you go along. 

As you construct a landscape, Panorama keeps track of how the fractal parameters and switches 
change from one Recursion Level to the next. The same sequence of parameter values and switch settings 
Se 
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will be recalled automatically for a new landscape--as long as you didn’t alter that parameter or switch at the 
highest Recursion Level attained before starting the new landscape or during the construction of the new 
landscape. You can examine the value of a numerical parameter without erasing the old sequence if you 
bring up the ‘Fractal’ requester and then exit the requester by clicking ‘CANCEL.’ Any change in one of the 
fractal parameters accepted by clicking ‘OK’ will reset that parameter to the new value for all higher 
Recursion Levels and for any new landscape started after abandoning the current landscape at the current 
Recursion Level. The sequences of parameter and switch settings are included in a Data file. 


More About Recursion Levels 


Panorama’s \andscapes are built in stages, called Recursion Levels. With each increase in Recursion 
Level the landscape becomes more finely subdivided into triangles. Each advance in Recursion Level — 
consists of two rounds of adding points to the landscape. During each round a point is added at the center of 
each triangle that makes up the landscape. The new point is assigned a random incremental height. Points 
are also added around the edge of the landscape. The new points and the old points are reconnected to form a 
new set of equilateral triangles which are oriented at 90 degrees to the triangles of the previous round. After 
the two rounds making up one Recursion Level, the triangles are oriented in the same way as at the end of 
the previous level, but the edge lengths are 1/3 as long; the area of the triangles is 1/9 as large, and the total 


number of points and triangles is roughly 9 times higher. The physical size of the landscape is a bit larger 
due to the extra points added around the edges. 


While a new Recursion Level is being calculated, the titlebar of the Control Window tells you what’s 
going on. It will announce, “Adding River Points,” and ‘Adding Land Points” for each of the two rounds. 
When the additions and subdivisions are finished, the program flashes the screen. From this point lakes can 
be filled, rivers run, the landscape drawn, and, if desired, some of the fractal spotamnesers can be changed in 
preparation for the next Recursion Level. 

Editing the Fractal parameters by clicking the box on the righthand side of the screen does not affect 
the landscape at the existing Recursion Level. Fractal parameters are applied to the next level up, and its 
requester window’s title indicates what level it will apply to. After you reach the highest Recursion Level in 
the program--level 5--the requester’s title reverts to “Recursion Level 1.” 

At the end of Recursion Level 1 there are 19 points and 24 triangles. You can customize the heights of 
individual points in the landscape and locations of the initial permanent springs that will determine the main 
river valleys through all subsequent Recursion Levels. At the end of the nth Recursion Level there are 2*9*n = 
+ 1 points in the landscape and (for n >1) about twice as many triangles. At the Recursion Level 5, the 
number of points is 118,099, and the number of triangles is almost as large as the number of pixels ina 
standard sized, hi-res interlace screen. = 


Spring Probability 


Springs and rivers are an important feature of Panorama. They play a key role in determining both the 
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large-scale and small-scale structure of the landscapes. Springs are sprinkled down at the beginning of the 
calculation of each Recursion Level. Each spring acts as the source of a river which flows down the path of 
steepest descent from the spring until it reaches the bottom of a local depression, or until it reaches the edge 
of the landscape, or flows into another, pre-existing river. As the landscape is subdivided more and more 
finely, new points are first added to define the paths of the rivers at each higher resolution. The hei ghts of 
new points adjacent to the rivers are constrained to be high enough to act as banks to preserve the courses of 
the rivers. This process at low Recursion Levels sculpts the main river valleys, while new springs at higher 
Recursion Levels produce smaller scale ravines and gullies. 

The ‘Spring Probability’ is the probability that a particular point will be identified as a spring. A 
requester for setting the “Spring Probability’ appears automatically when starting a new landscape and at the 
start of each new Recursion Level when you select ‘By 1’ in the ‘Increase Level’ submemu of the ‘Actions’ 
menu. As with any probability, the value must be a number in the range 0.0 to 1.0. If it is 0.0, there will be 
no springs. If it is 1.0, then every point capable of acting as the source of a river or rivulet is identified as a 
spring. Separate values are stored for each of the five Recursion Levels. Initially these are default values, in 
the pattern 1.0, 1.0, 0.43, 0.185, 0.08. If you change any of these values, the changed values are remembered 
from one landscape to the next. 

The higher the Spring Probability the more ravines and gullies, and the more “eroded” the landscape 
will appear. Also, because heights of new points along the course of each river are constrained to maintain a 
monotonic downward slope, more springs usually mean fewer local depressions which can become lakes ~ 
when the landscape is rendered. A low Spring Probability allows the meandering of the rivers to develop to 
the maximum extent permitted by the value of the Meander Slope parameter. 


Permanent Springs 


Springs laid down at the beginning of a new Recursion Level can be either permanent or temporary. 
The locations of the permanent springs are stored (up to 1200 of them) and preserved from one Recursion 
Level to the next. Rivers from permanent springs are automatically regenerated at the beginning of each new 
Recursion Level, if they have been erased by actions such as filling lakes. Only the permanent springs and 
any full lakes can act as sources of rivers when rivers are run explicitly to give them a non-zero width when 
rendered. The limit of 1200 is enough to accomodate a 1.0 Spring Probability up through Level 4. If you 
want to be able store Level 5 springs you should keep the Spring Probability at Level 5 less than about 0.08. 
If the limit is exceeded when laying down springs at the beginning of a new Recursion Level, all the new 
springs are made temporary springs. Normally you will not want to show as many rivers as you are apt to 
get from Level 4 and 5 springs. 

Temporary springs are not stored, and the rivers they produce will last only as long as rivers are not 
erased. Old rivers are automatically erased by filling lakes or running rivers. 

The springs will be permanent for the next Recursion Level if the ‘Perm Springs’ item of the ‘Fractal’ 
menu is checked, and temporary otherwise. The default is to have Permanent Springs on. 
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“Rerun Rivers’ 


If the “Rerun Rivers’ item in the ‘Fractal’ menu is checked when starting a new Recursion Level, all 
existing rivers are erased, and then rivers are regenerated from the permanent springs and any new springs 
sprinkled down. In particular, this means that rivers from Jakes will not play any role in molding the 
landscape, as they can if ‘Rerun Rivers’ is off. The meandering of rivers is maximized when ‘Rerun Rivers’ 


is off. The default is ‘Rerun Rivers’ on. 


The ‘Fractal Index’ 


When a new point is added to the landscape, its height is chosen randomly from a certain range of 
values. The magnitude of this range is the fluctuation amplitude. In each round of adding points, the 
fluctuation amplitude is decreased by dividing the previous fluctuation amplitude by the Fractal Index. The 
larger the Fractal Index, the more rapidly the fluctuation amplitude decreases. The triangle edge length 
decreases by a factor of 1/Sqrt(3) between each round of adding points. If the Fractal Index is larger than 


Sqrt(3) = 1.732, the landscape gets smoother and smoother on the scale of the new triangles as the Recursion 


Level increases, and strictly speaking the landscape is not a fractal at all. Values less than 1.732 mean the 
landscape gets rougher (slopes get steeper) at higher Recursion Levels, implying a “fractal dimension” 
greater than 2. The About Fractals chapter explains more about the concept of fractal dimension. 

The slider in the Fractal requester normally gives access to values between 1.3 and 1.9, although 


values of 1.0 to 10.0 will be accepted when entered in the text gadget. The fractal dimension approaches 3 as 


the Fractal Index approaches 1.0, which means the surface of an infinite-recursion-level landscape would 


become infinitely jagged, densely filling some portion of three-dimensional space. 


You should consider adjusting the vertical scale of the landscape when you change the Fractal Index 
to keep the small-scale roughness of the landscape within reasonable bounds. The small-scale roughness, 
rather than the Fractal Index as such, is what dominates the visual impression of the landscape, and the 
small-scale roughness is not likely to be extremely large or (in the presence of a reasonable amount of large 
scale-relief) extremely small in the real world. For example, the default sequence of values for the Fractal 


Index is 1.6,1.6,1.6,1.7,1.8 with a vertical scale of 2000.0. 


The ‘High FrDim’ preset in the ‘Fractal’ menu gives a sequence of values 1.4,1.4,1.5,1.6,1.7 with a 
vertical scale of 1000.0, and the ‘Low FrDim’ preset gives a sequence 1.7, 1.7, 1.7, 1.7, 1.8 with a vertical 


scale of 2800.0. 


The varying fractal index (and therefore fractal dimension) with horizontal scale corresponds roughly 
to what is seen in real landscapes. Generally, the fractal dimension is about 2.5 on scales greater than a few 
kilometers, and decreases to close to 2.0 on scales less than a kilometer. The fractal dimension 
corresponding to a given fractal index is shown at the top right of the ‘Fractal’ requester window. The 
absolute size of a ‘High FrDim’ landscape should be thought of as perhaps 30 or 40 kilometers across, while 
that of a “Low FrDim’ landscape might be only 3 or 4 kilometers across, with a ‘Default’ landscape coming 


somewhere in between. 
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‘The ‘Relief Bias’ 


Natural landscapes tend to be more rugged at high elevations (mountains) and smoother at low 
elevations (valleys). The Relief Bias parameter of the ‘Fractal’ requester allows you to achieve this kind of 
effect (or its inverse), even though the Fractal Index is the same everywhere. 

The Jocal fluctuation amplitude used in selecting the height of a point is the global value calculated 
from the Vertical Scale and the Fractal Index times a Relief Bias factor which depends on the average height 
of the neighboring points. When the Relief Bias parameter b is greater than 0.0, the relief is enhanced at 
positive heights (z>0.0), and when b<0.0 the relief is enhanced at negative heights (z<0. 0). What happens 
when b*z<0 depends on whether you select the ‘High Only’ or the ‘High/Low’ subitem of the ‘Relief Bias’ 
submenu of the ‘Fractal’ menu. With ‘High Only’ the Relief Bias factor is 1 if b*z<0 (no effect). With 
‘High/Low’ the landscape is smoothed when b*z<0. 

The checkmark in the ‘Relief Bias’ submenu shows you which option is in effect. Use positive values 
of the Relief Bias parameter to get ragged mountains with either normal (‘High Only’) or smoothed 
(‘High/Low’) valleys. 

The default option is ‘High Only,’ and the default value of the Relief Bias parameter is 3.0. Most of 
the time this will give fairly strong exaggeration of the relief at the hi gher elevations in the landscape, but 
the strength of the bias depends on the luck of the draw in that the height (relative to the Vertical Scale) of 
the higher elevations will vary from landscape to landscape. The relative strength of the Relief Bias is 
independent of the Vertical Scale. If you don’t want the Relief Bias to be too extreme, it is probably a good 
idea to reduce it to 2.0 or 2.5 when the Fractal Index is below its default value of about 1.6. 

To get “hilly” rather than “mountainous” landscapes, set the Relief Bias parameter to 0. If you want a 
rugged canyon through a plateau, choose ‘High/Low’ and make the Relief Bias parameter strongly negative. 

The slider in the requester covers the range -4.0 to 4.0; values between -10.0 and 10.0 are accepted in 
the string gadget. Note that large positive values may lead to runaway exaggeration of the mountain relief. 


The ‘Vertical Offset’ 


The Vertical Offset parameter accessible in the ‘Fractal’? menu determines how the range of possible 
new heights for a point is adjusted relative to the reference height--which is the average height of the 
neighboring points (the three corners of the surrounding triangle for a new point or the six neighbors of a 
“jiggled” old point). The range is centered on the reference height when the Vertical Offset is 0.0--the 
default value. That is, the new point is equally likely to be higher or lower than the reference height. When 
the Vertical Offset parameter is positive, the range of possible new heights i is shifted upward; when negative, 
the range is shifted downward, but the fluctuation amplitude stays the same. When the Vertical Offset 
parameter is 1.0, the lower end of the new height range is just at the reference height, and when it is -1.0 the 
upper end of the the new height range is at the reference height. 

Positive values of the Vertical Offset parameter tend to produce more sharply entrenched river valleys, 
while negative values tend to broaden the river valleys and (when ‘J iggle Old’ is off) drag down the 
landscape around the initial points in the landscape, leaving them as isolated, horn-like peaks, 
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‘The slider accesses values in the range -1.0 to 1.0, while values from -2.0 to 2.0 are acceptable to the 
string gadget. 


‘Jiggle Old’ 


Selecting ‘Jiggle Old’ in the ‘Fractal’ menu toggles between two modes of generating heights for 
points in the landscape. With the default option, which is in effect when ‘Jiggle Old’ is not checked, the 
height given to a point when it is first created is preserved through all subsequent rounds of adding points to 
the landscape. When ‘Jiggle Old’ is checked, after each round of adding new points (two for each Recursion 
Level) all the old points not on or adjacent to rivers are given a random increase in hei ght, using as a 
reference height the average height of the six new points at the midpoints of the adjacent old triangles. The 
fluctuation amplitude is the same as for the new points just added. The fluctuation amplitude depends on the 
reference height through the same Relief Bias function, and the Vertical Offset is the same. 

When ‘Jiggle Old’ is in effect, the landscapes generated with a given Fractal Index tend to have a 
somewhat smoother appearance, with fewer sharp pinnacles and Cliffs. Thus the jiggled landscapes are 
usually less dramatic, but they approximate more closely ideal “fractional Brownian motion” in which the 
statistical properties of the heights of points in a neighborhood of a given point are independent of the 
Recursion Level at which the given point was created. Without jiggling, a point created at a low Recursion 
Level cannot adjust to the height of its surroundings as the landscape develops, perhaps resulting in a very 
sharp peak or a very deep lake surrounded by steep Cliffs. 


‘Island Mode’ 


When the ‘Island Mode’ item in the ‘Fractal’ menu is checked, new points added at the edge of the ier 
landscape are forced to be lower than the average height of the adjacent old points. If you arrange the points 
on the edge of the landscape at Recursion Level 1 all have low elevations, then the edge of the landscape 
will remain low as the Recursion Level is increased, so that the entire edge of the final landscape can be put 
below sea level without drowning most of the landscape. 


The ‘Meander Slope’ = 


The rivers present during the calculation of a new Recursion Level are subdivided along with the 
landscape triangles and given wiggles from side to side. When points are added at the midpoints of the _— 
triangles, a river which went along a triangle edge is forced to go through the midpoint of one of the two 
adjacent triangles. Whether these wiggles accumulate in coherent meanders or randomly cancel each other 
Out is controlled by the ratio of the actual slope of the river along a triangle edge (the height difference 
_ between successive corners divided by the edge length) to the Meander Slope parameter. When the actual 
slope is less than the Meander Slope parameter, the direction of the wiggle immediately downstream from a 
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bend in the old river course is always chosen toward the outside of the bend. That means the river tries to 

straighten its course. When the old course was straight, the new wiggle downstream is randomly to one side 
or the other with equal probability. The more the actual slope is greater than the Meander Slope parameter, 

the more random the direction of the wiggle from a bend in the old river course--although there is still a 

significant bias toward the outside of the bend when the ratio of the slopes is as large as 4.0. 
= Paradoxically, the more the river tries to strai ghten itself, the more it meanders. This mimics the actual 
physical process which causes rivers to meander. The point is that a wiggle to the inside of the bend 
sharpens the bend, but if the bend gets too sharp the river cuts through, ending up straighter than it was _ 
before. 

To maximize meandering, set the Meander Slope parameter large enough that it will exceed the actual 
river slope almost everywhere. A value of 0.1 is usually sufficient. Side streams running into the river tend to 
destroy meanders, so you should start at Level 1 with a few rivers from permanent springs, setting the 
~~ random Spring Probability to 0. Also, running rivers tends to cut through sharp meanders, so turn off ‘Rerun 

Rivers’ in the ‘Fractal’ menu and don’t ‘Fill Lakes’ (which forces rerunning of the rivers from permanent 

springs) until you reach the Recursion Level at which you will do the rendering. 
as To minimize meandering, set the Meander Slope parameter to 0.0 and/or have a fairly high random 
Spring Probability, and turn on ’Rerun rivers’ in the ‘Fractal’ menu. 

The default value of 0.02 for the Meander Slope is in-between. In a typical landscape with few 
random springs, the enhancement of the meandering will be fairly strong where the river slope is low, but 
the meandering will be suppressed where the river slope is steeper. Values from 0.0 to 10.0 are accepted in 
the string gadget; the normal range of the slider is 0.0 to 0.04. 

Changing the overall vertical scale of the landscape also changes the Meander Slope parameter by the 


same factor, so the amount of meandering is unaffected when all you do is change the Vertical Scale 
parameter. 


= ‘Rescale Old Z’ 


The number entered for ‘Rescale Old Z’ is used to rescale the height of each point in the landscape at 
the current Recursion Level, without changing the height fluctuation amplitude at higher Recursion Levels. 
The Vertical Scale parameter remains the same. The slider covers the range 0.2-1.0, and values from 0.1 to 
10.0 are accepted in the string gadget. 

Reducing the range of heights at a low Recursion Level makes the fluctuations in the landscape 
introduced at higher Recursion Levels more prominent. With some experimenting, you can make a a range 
of many small mountains instead of a landscape dominated by a few large mountains. This effect can also be 
— produced by changing the Fractal Index from small values (1.3-1.4) at low recursion levels to high values 
(1.6-1.7) at high Recursion Levels. 

The Meander Slope parameter and the River Depth parameter are unchanged by this rescaling. 

After a height field is loaded from an external data file, you may find it desirable to reset the hei ght 
fluctuation amplitude without changing the current heights in the landscape. Do this by combining ‘Rescale 
Old Z’ with a new value of the Vertical Scale parameter. For instance, to double the height fluctuation 
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amplitude while leaving the existing heights the same, ‘Rescale Old Z’ with a factor of 0.5, then increase the 
Vertical Scale by a factor of 2. 


Seeds for Random Number Generator 


“Random” numbers produced by a computer are not really random. “Unpredictable by mere 
humans” would be a better way to describe them than “random.” Purists call computer “random” number 
sequences “pseudo-random,” and they are. Any sequence of numbers follows uniquely from an initial 
“seed.” This is because of the way “random” numbers are generated by computers. You can recreate a 
landscape if you use the same seed and follow exactly the same procedures with exactly the same 
parameters. In this way, you can perform controlled experiments on how the different fractal parameters, 
spring probabilities, etc., affect the final form of the landscape--changing one parameter at a time while ~ 
. always using the same seeds. 

With the default fractal parameters or one of the preset fractal parameters, writing down the fractal 
seed is all you really need to do to recreate the landscape. Develop your own list of seeds that give 
particularly interesting landscapes. The current seed for the landscape generation is displayed in a text 
gadget in the ‘Fractal’ requester, as is the seed for “‘Roughening’ the landscape. The two seeds can be 
changed independently at any time, though initially the ‘Roughen’ seed is the same as the fractal seed. 
Allowed values for any of the random number generator seeds used in Panorama are positive integers in the 
range 1 to 2147483647. 


Data Files 


A Panorama “data” file contains the height data and other information necessary to recreate a 
landscape. Data files can be saved at any Recursion Level, whenever you want to be able to come back to 
the data, perhaps to branch in a different direction with your experimentation. Saving a landscape in a data 
file makes it possible to retrieve exactly the same landscape at some later time. The size of a data file 
increases drastically with Recursion Level. It’s 55-90 kilobytes for a Level 4 landscape, but about 500-730 
kilobytes for Level 5. The lower disk usage results from saving just the height data, and the higher values 
include saving lakes’ locations and heights as well. The final size of a data file depends on the number of 
springs and lakes. Besides the heights of all the points in the landscape, the data file contains the values of a 
all the parameters specifying the landscape, including the original random seeds, the fractal parameters, the 
rendering parameters set in the ‘Features’ menu, and the colors for both solid and wireframe draw modes, 

However, the parameters in the ‘View’ menu relating to the observer, the camera lens, and the sun position = 
are not included, and neither are the current selections of the draw mode, etc., in the ‘Switches’ menu. 
(These are relegated to “Settings” files.) 

If lakes are not saved with the data file, they can be recreated by filling lakes after you load the = 
landscape--although this can take quite a while for a Level 5 landscape. 

Landscape Data filenames are automatically given a “‘.data”’ extension when the file is created, and 
a a 
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must have this extension to be accepted by Panorama. 

When you select ‘Save Data,’ the file requester window opens with its title reminding you that you are 
saving data. Select a drive (and optionally a directory), and type in a filename. You don’ t need to include the 
“data” extension when you type the filename, but it’s all right to do so. 

If you change your mind, click ‘Forget It.’ If you exit the file requester by clicking ‘OK!,’ and if there 
are lakes present in the landscape you’re saving, another requester appears, asking if you want to save lakes. 
Click ‘OK’ if you do, ‘CANCEL’ if you don’t. 

If Panorama discovers there is insufficient disk space, it will automatically abort the save and put up a 
requester to inform you. If an error occurs which aborts the save operation, any partial file is erased. 

Saving files to the RAM: disk in memory is a special case, since AmigaDOS considers the RAM: disk 
to be always full. If the directory path begins with RAM:, Panorama will pop up a requester that says 
“Saving to RAM disk.” After clicking ‘OK’ or ‘CANCEL,’ a second requester appears telling you the size 
of the data file. If there is any question about having enough memory to hold the file, you should abort the 
save by clicking ‘CANCEL.’ If you okay the operation, saving proceeds in the normal manner, including the 
requester asking whether you wish to save lakes with the data file. AmigaDOS will not permit the RAM: 
disk to use up the last smidge of memory in the computer, so your estimate of whether you have “enough” 
to do the save must stop some kilobytes short of using up all available memory. Make sure you have at least 
20 kilobytes over what you need before you go ahead with a save to memory. 

The procedure for loading a data file is similar to the ‘Save’ operation. Select ‘Load Data’ from the 
‘Actions’ menu. Enter the path and filename in the file requester. The file itself must have the “.data” 
extension on the end of its filename, and the file requester will display only those files in the current 
directory which have this extension. Loading will be aborted if the file does not contain the proper header, or 
if there is an error in reading the data. If the error occurs after all the height data is loaded, the new 
landscape will be in effect, but with lakes left unfilled. 

If lake data is successfully loaded from the file, and all the lakes are full, the ‘Fill Lakes’ item in the 
‘Actions’ menu will be checked. Also, if rivers were present when the data was saved, the same rivers from 
springs and lakes will be automatically recreated, and the ‘Run Rivers’ item will be checked. 

See Appendix E for the details of the data file format. This information is made available for those 
who want to write their own programs to import height data from some external database or generated by 
something like a Mandelbrot set program. 


Reduce Level 


Whenever the current Recursion Level is greater than 1, you have the option of reducing Recursion 
Level by one. The points present in the landscape at the lower level keep the heights they had at the higher 
level, so the lower level landscape is not necessarily the same as it began. Heights are altered if ‘Jiggle Old’ 
was in effect when the higher level was created, or if heights were adjusted at the higher level using the 
“ChangeHeightAt’ ARexx command. Reducing the Recursion Level can be useful to free up memory, and 
cycling back through a lower Recursion Level is a way of generating a series of landscapes with the same 


‘basic structure, but randomly different small-scale variations. Springs introduced in the generation of the 
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higher level are discarded when the level is reduced. 
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SECTION V: 
Fancy Rendering 


This section is your guide to unleashing the full power and flexibility of Panorama’s rendering 
machine by adjusting the parameters and toggles accessible through the buttons on the righthand side of the 
Control Window. Remember, the buttons are your key to the nitty-gritty controls for things. You can obtain a 
more generalized control of the same parameters using the pulldown menus. The intent is to have mostly 
automatic defaults go into action from the pulldown menus, and provide the maximum control with the 
buttons. Which one of the control mechanisms you use depends on how picky you want to get and how 
much you’re willing to learn about the way the program does its thing. You don’t need much knowledge of 
Panorama to get great pictures using the pulldown menus, and even exercise a considerable amount of 
control over the effects. For maximum control, put up with the higher complexity of the requesters you get 
when you click the control buttons. All of the parameters mentioned are explained in detail in this section. 

Everything discussed here can also be adjusted using “Settings” files, in Picture Scripts, and through 
ARexx commands executed either as part of an ARexx macro or directly through the ARexx Command 
window opened by selecting the ‘ARexx Command’ item in the ‘Actions’ menu. For a number of effects, the 
menu structure lets you load specific elements of a previous effort from a file. 


Contour Requester 


In Panorama, the Contours are like the floors in a department store. Each Contour, or level, relates to 
some division of the overall height in a landscape, somewhat as you’d find in the real world. There might be 
beaches, grasslands, forests, rocky slopes above the treeline, snowy mountaintops, etc. All of these might 
have different colors, but we focus here on their other attributes. Panorama gives you maximum control 
over every aspect of each Contour, including how the boundaries between the countours mix and blend 
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together and respond to the steepness and curvature of the landscape as well as the height. 
When the ‘Contours’ requester opens, the relative height of sea level is displayed in the top right 


comer of the window. You can change the sea level here, if you prefer, so you can adjust your Contour top 
heights in relation to it. 


The long horizontal bar at the top left of the requester is not a gadget; its purpose is to show ae 
graphically the relative positions of the Contour boundaries. The Contour top hei ght currently active 
(initially, the lowest Contour) is marked by a red line; the other Contour boundaries are dark gray lines. Sea 
level will be shown as a blue line if its relative value is between 0.0 and 1.0. The bar represents a range of a 
fractional heights from 0.0 on the left (representing the lowest point in the landscape). to 1.0 on the right (the 
highest point in the landscape). Any Contour boundaries outside this range are not shown. 

The four (in Solid Draw mode) parameters with both text gadgets and sliders refer to Contour 
boundaries, and are set one Contour at a time, with the lower Contour indicated in the requester window title 
bar. In Wireframe mode only the Contour top heights are present. The currently active values are indicated 
by the numbers which are on shaded buttons. The values for the next higher Contour (boundary) become 
active when you click ‘NEXT’ at the lower left of the requester window. You can exit the requester at any 
time, accepting the changes you have made to the parameters, by clicking the ‘EXIT’ button. To abort 
without any of the changes taking effect, click ‘CANCEL.’ 
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‘Rel Top Heights’ 


The starting point for the division into Contours is the nominal height for each boundary between 
Contours. In Panorama the ‘Rel Top Height’ is stored for each Contour as a fraction of the range between 
the lowest and highest points in the landscape, i.e., as a “relative height”. The top height of a Contour must 
be greater than or equal to the top heights of all lower Contours. The top heights are stored separately for the 
solid and wireframe rendering modes. There are 5 Contours for solid rendering modes, 6 for wireframe 
modes. 

The ‘Rel Top Height’ slider moves in a range of 0.0 to 1.0 for both solid and wireframe Contours. For 
solid mode Contours, values from -1.0 to 2.0 are accepted in the string gadget, however, and this range is 
honored by the program when the parameter is loaded from a “Settings” file. 

The Contour boundaries shown on the bar at the top of the window are updated when you alter the top 
height for the current Contour using either the slider or the string gadget. Note that if you raise the top height 
of the current Contour above some of the top heights of higher Contours, the top heights of the hi gher 
Contours are no longer displayed. This is because the old top heights are no longer valid, since the top 
heights must not decrease as the Contour number increases. The offending top heights are altered 
automatically to tentative default values when you go on to the next level. 


‘Slope Blending’ and ‘Null Slope’ 


During precalculation of Contour and Cliff assignments, each point in the landscape is assigned an 
effective height which differs from its true height by an amount depending on the local steepness and 
curvature of the landscape. If, as is always the case with Faceted shading, rendering is done without this 
precalculation, an effective height is calculated for each triangle as the average of the heights of the three 
comers of the triangle modified by an amount depending on just the steepness of the triangle. In either case, 
the Slope Blending and Null Slope parameters control how the effective height depends on steepness. It is 
this effective height, not the true height, which is used during rendering to assign points or triangles to a 
Contour. 

The magnitude of the Slope Blending parameter gives the total range of the effective height 
adjustment (as a fraction of the total range of heights in the landscape) due to the local steepness (.e., slope) 
of the landscape. There is no height adjustment if the local slope is equal to the Null Slope parameter, except 
that if the Null Slope parameter is 0, a default value for the Null Slope equal to ratio of the fractal height 
fluctuation amplitude to the triangle edge length is used. When the Slope Blending is positive, a local slope 
greater than the Null Slope lowers the effective height by up to 1/2 the magnitude of the Slope Blending, 
while a local steepness greater than the Null Slope raises the effective height by up to the same amount. The 
limit of the effective height adjustment is approached according to the ratio of the local slope to the Null 
Slope. When the Slope Blending parameter is negative, the effective height is raised for slopes steeper than 
the Null Slope, and lowered for gentler slopes. The range of allowed values for Slope Blending is -10.0 to 
10.0, but a reasonable range to consider is -0.25 to 0.25. The allowed range for the Null Slope is 0.0 to 10.0. 

Just how the effective height adjustment is accomplished when there are different values of these 
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parameters for each Contour boundary, perhaps giving conflicting Contour assignments, is explained under 
“Priorities and Strategies.” 


Curvature Blending and Curvature mode 


The second component of the effective height adjustment is based on the local ‘curvature’ of the 
landscape, where the curvature is positive if the surface on average is bent upward, as in a gulley or a pit, 
and negative when the surface on average is bent downward, as on a ridge or a peak. This takes effect only 
when Contour and Cliff precalculation has been enabled by choosing ‘Gouraud,’ ‘Better,’ or ‘Best’ shading 
from the ‘Shading Type’ submenu. 

There are two choices for the Curvature mode, a ‘Local’ mode in which the curvature at a point is 
calculated by comparing the height of the point with the heights of its 6 nearest neighbors, and a ‘Nonlocal’ 
mode in which, for Recursion Levels 4 and 5, the curvature is a kind of fractally averaged curvature over the 
nearest points and a sampling of more distant points. There is no difference between the two modes for 
rendering at Recursion Level 3 or below. Click the ‘Curvature Mode’ button in the Contour requester to o? 
toggle between these two modes. The default ‘Nonlocal’ mode requires a modest extra amount of 
precalculation time at the high Recursion Levels, but is definitely recommended for the superior results it 
gives. 

As in the case of Slope Blending, the magnitude of the Curvature Blending parameter is the range 
over which the effective fractional height is adjusted. A positive value raises the effective height when the 
curvature is positive and lowers it when the curvature is negative. The effect reverses when the Curvature 
Blending is negative. The range of allowed values for Curvature Blending is -10.0 to 10.0, but it is most 
effective in the range -0.3 to 0.3 under most circumstances. 


Contour Dither 


Like Slope Blending and Curvature Blending, Contour Dither is associated with Contour boundaries, 
rather than individual Contours, and like Curvature Blending it takes effect only with Contour and Cliff 
precalculation enabled. The allowed values are integers in the range from 0 to 64. The four text gadgets in 
the Contours requester are for the 1-2, 2-3, 3-4, and 4-5 boundaries going from left to right. The larger the a 
value the more the Contour boundary is made “fuzzy” by dithering the Contours together on a 
pixel-by-pixel basis, with the relative proportions of the Contours depending on how close the effective 
’ height is to the boundary height. A value of 0 means a sharp boundary between the Contours. Values less — 
than 4 might be appropriate for a rock-snow Contour boundary, while larger values might be desirable for a 
grassland-forest or a forest-rock boundary. A substantial amount of Contour mixing is achieved with values 
about 20, and with values near the maximum 64, the dithering extends over the whole range of heights in the 
landscape. 


a a a 
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Contour Texture 


Within a given Contour, the Contour Texture controls how the brightness fluctuates from pixel to 
pixel. You can choose between two types of dither patterns, which differ in whether the brightness variations 
are on as fine a scale as possible (values 0 to 32) or whether pixels of the same brightness are clumped 
together more than necessary to give a somewhat rougher texture (values 33 to 64). In future versions of 
Panorama additional texture types might be added. In normal Amiga rendering, dithering together different 
brightnesses is necessary to avoid pronounced banding from the relatively large brightness steps associated 
with 12-bit color, and the texture value within each type range is irrelevant. In 24-bit rendering, a texture of 
0 means no brightness variations except as determined by the brightness interpolation within each triangle. 
Otherwise, the actual RGB values are larger or smaller than the nominal values determined by interpolation, 
by the texture value or, if the texture value is greater than 32, by the texture value minus 32. Which pixels 
are brighter and which are smaller is determined by the dither pattern. The dither pattern is always fixed on 
the screen to reduce flickering of pixels in animations. 


Shadow Dither 


The Shadow Dither parameter is, like the Contour Dither, an integer in the range 0 to 64 for each 
Contour. This is used to soften the edges of shadows on the side toward the sun, i.e., where there is a shadow 
line at the top of a ridge or the top edge of a steepening slope, and also comes into play where the sun is just 
grazing the surface of the landscape even if there is no actual shadow. A fraction of the pixels are drawn in 
the shadow color, depending on how close the landscape is to being in shadow at that point. The effect can 
be quite striking, and gives the impression of small shadows being cast by bushes, trees, or a rough rocky 
surface. The fraction of pixels in shadow at a given distance from the shadow edge and the amount of 
landscape affected increases as the Shadow Dither is increased. 

Shadow Dither is effective when Smooth Shading is On for the Contour, but probably is best set to 0 
when the Shading Type is Faceted or Smooth Shading is Off since the amount of shadow dithering may then 
change abruptly at triangle edges. 


Priorities 


The effective height used to determine Contour boundaries may be quite different depending on 
whether the Contour boundary parameters used are those for the 1-2 boundary, or the 2-3 boundary, etc. The 
potential conflict is resolved by a set of priorities, which are applied pixel-by-pixel when Contour dithering 
is in effect (“Best’ rendering mode and ‘Smoothing On’ for all Contours), and otherwise triangle by triangle. 
First, based on where the effective height is relative to the 4-5 ‘Rel Top Height,’ and on where the pixel is in 
the appropriate Contour dither pattern, both selected according to the 4-5 Contour Dither value and the 


‘distance of the effective height from the 4-5 boundary height, a decision is made as to whether or not the 


triangle or pixel belongs to Contour 5. If not, the next decision is whether, based on the Contour boundary 
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parameters for the 1-2 boundary, the triangle or pixel belongs to Contour 1. If not, the next decision, based 
on the 3-4 Contour boundary parameters, is whether the Contour or pixel belongs to Contour 4. If not, then = 
based on the 2-3 Contour boundary parameters the pixel is assigned either to Contour 3 or to Contour 2. 
Thus, Contour 5 has priority over Contour 1 which has priority over Contour 4, with priority then in order of 
decreasing Contour number, Contour 2 being the last resort. = 
The main reason for this priority order is to allow Contour 5 as ‘snow’ to have a sharp lower edge and 
Contour 1 as a sandy ‘beach’ to have a sharp upper edge, while the other Contours are strongly dithered 
together. As the last resort, Contour 2 can be considered a “dirt” Contour. 


The ‘Cliffs’ requester 


The Cliff parameters consist of three global parameters, the Cliff Curvature Bias, the Cliff Texture, 
and the Cliff Shadow Dither, plus two parameters which can take on different values for each Contour, the 
Cliff Slope Angle and the Cliff Texture. The ‘Cliffs’ requester has only text gadgets for setting these ss 
parameters, and there are no constraints requiring any relation between values for different Contours. After a 
triangle or pixel is assigned to a Contour, the Cliff parameters for that Contour and the global Cliff 
parameters control whether the triangle or pixel should be reassigned as a Cliff. = 
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Cliff Slope Angle 


The primary Cliff parameters are the Cliff Slope Angles for each Contour. The row of 5 text gadgets is 
for the 5 Contours, increasing from left to right. The Cliff Slope Angle determines the nominal landscape 
slope above which the triangle or pixel is assigned to Cliffs and below which it is assigned to the selected 

~~ Contour. As with the Contour determination, when the Contour-Cliff precalculations are turned on and the 
Cliffs have Smoothing On, the actual slope of the landscape is adjusted to an effective value for comparison 
with the critical Cliff slope for the Contour to which the pixel belongs. 
— The range of possible values for the Cliff Slope Angle of each Contour is any real number between 0 
(degrees) and 90.0 (degrees). Small values mean most of the Contour will be treated as a Cliff, large vallies 
that little or none of the Contour will be treated as a Cliff. 


Cliff Curvature Bias 


When this parameter is set to positive values the effective Cliff slope is increased where the landscape 
Curvature is positive (landscape bends upward, as in a gully) and decreased where the landscape curvature is 
negative (as on ridges or mountain peaks). This enhances Cliffs on the ridges and suppresses them in the 
— gullies. The allowed range is -10.0 to 10.0, but in fractal landscapes which tend to be fairly rough on small 

scales and thereby have relatively large curvature values a reasonable range is -0.3 to 0.3. Somewhat larger 

values might be appropriate with landscapes from DEMs, which are often very smooth on small scales. 
_. However, even then a magnitude greater than 1.0 or so will have rather exaggerated effects. 


Cliff-Contour Dither and Cliff Edge Type 


The Cliff Edge Type can be toggled among three modes, ‘Sharp,’ ‘Fuzzy,’ and ‘Diffuse,’ by clicking 
on the Cliff Edge Type button in the ‘Cliffs’ requester. The Cliff Edge Type determines how the 
Cliff-Contour Dither parameter for each Contour acts in giving a more or less gradual transition from 
Contour to Cliff through dithering, i.e., interspersing pixels assigned to Cliffs and pixels assigned to the 
appropriate Contour. All of this takes effect only if the Contour and Cliff precalculation is active and the 
___ Cliffs have ‘Smoothing On’. Otherwise, the Cliff boundaries are sharp and run along triangle edges. 

With a Cliff Edge Type of “Sharp,” there is no dithering together of the Contours and Cliffs 
regardless of the values of the Cliff-Contour Dither parameters, though the Cliff edges are interpolated 
within triangles. 

With a Cliff Edge Type of ““Fuzzy”’ the fraction of pixels assigned to Cliffs increases fairly smoothing 
from 0 to 3/4, and then jumps suddenly to 1. This makes the Cliff edges more or less fuzzy, depending on 
the value of the appropriate Cliff-Contour Dither parameters, but keeps the really steep parts of the Cliffs 
completely free of the Contour color(s). 

With a Cliff Edge Type of ‘Diffuse’ the dithering density gradually changes from all Contour to all 
Cliffs, and when the relevant Cliff-Contour Dither parameter is fairly large, some Contour pixels will be 
a a Sh 
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found well away from the Cliff edges. This is the default option. 

The Cliff-Contour Dither parameters can have integer values in the range 0 to 64; the larger the value 
the more smeared out the Cliff edges are. Values less than 4 might be appropriate for snow and beach 
Contours, while the default value for Contour 3 as a “tree”? Contour is 24. 


Cliff Texture and Cliff Shadow Dither 


These two integer parameters have ranges from 0 to 64 and function in the same way for Cliffs that 
the Contour Dither and Shadow Dither parameters function for Contours. The default values of 6 and 5 give 
a moderately smooth texture and a relatively small amount of shadow dither, as would be appropriate for a 
fairly smooth rock face. 


The ‘Trees’ requester 


What would a landscape be without trees? West Texas? Okay, what would a mountainous landscape 
be without trees? Nature makes trees in several varieties, and so does Panorama. Of course, Nature makes 
them out of bark and leaves, and Panorama has to use mathematics. Oh, but the fancy mathematics in a 
Panorama makes such nice trees! Turn them on with the ‘Trees’ button, and have a look--remember, Trees 
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don’t work in anything less than Amiga HAM, so you’ll have to turn on 24-bit rendering before you draw 
the picture. When it’s done, convert to HAM, and stand back. 

Quite realistic-looking trees can be included in Panorama landscapes through a bit of fractal magic 
known as “Iterated Function Systems”. To learn more about how this works, try our the freely distributable 
“Ifs” program on Fred Fish Disk Number 321. If you’re able to wade through some fairly heavy 
mathematics, take a look at the book Fractals Everywhere by Michael Barnsley. 

Panorama’s trees are not “‘drawn’’ to the screen in any usual sense; instead, they sort of “dissolve” 
onto the screen while the computer does some calculating. The trees are not drawn in their proper colors on 
standard Amiga screens, due to the limited palettes, and therefore by default they are not even turned on. To 
see the trees you must have 24-bit turned on, and should either convert the 24-bit picture to HAM mode to . 
see it on your Amiga monitor, or (even better) view the 24-bit picture on a 24-bit display device. 

Turning Trees on can slow down picture rendering substantially, particularly when the camera is close 
enough to the landscape that individual trees fill a substantial part of the picture. It’s a good plan to create 
everything else you want, and then switch Trees on for the final rendering. 

Panorama lets you control the properties of Trees using a number of switches and parameters which 
can be set separately for each Contour and for Cliffs. As in Nature, too, no two trees are precisely alike. A 
random number generator is used to vary the placement of trees on the landscape, but in such a way that the 
location and shape of each tree is reproducible from one picture to the next of the same landscape--to permit 
animation to work realistically. 


On/Off toggle 


Turn Trees on (or off) using the On/Off button in the ‘Trees’ requester, or toggle the Trees ‘On’ item in 
the “Trees’ submenu of the ‘Features’ menu. Turing trees on will only take effect if 24-bit is enabled. Also, 
no trees will be drawn in the picture unless the observer “Vert ViewAngle” is less than 20 degrees. The 
reason for this is that Panorama’s trees are two-dimensional and are only designed to look right when the 
observer is looking more or less horizontally at them. 


Tree Seed 


This special seed for the random number generator is used to place the trees in the landscape and to 
generate random variations in their sizes and shapes. By default it equals the main Fractal Seed, but it can be 
set independently and is stored along with the Tree parameters in a “Settings” file. If you want the trees to 
Stay in the same place for succeeding pictures, don’t change this number between them. 


Type 


You have a choice among three types of trees for each Contour level and the Cliffs. There is a fairly 
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generic, leafy tree labeled “Oak,” a fir tree with branches angled upward labeled ‘DFir,’ since it resembles a 
Douglas Fir, and a fir tree with branches angled downward—‘AFir,’ short for Alpine Fir. The ‘Type’ gadgets 


on the top row cycle through these options. The buttons do not turn trees on or off for the various Contours 
to which they relate. 


Spacing 


Tree Spacing controls how densely trees will be drawn—individually adjustable for each of the 
Contours and for the Cliffs. A value of 0.0 for Tree Spacing means no trees. Note that this in effect permits = 
you to turn Trees off for any Contour or the Cliffs. If the value entered is greater than 0.0, the Tree Spacing 
will be the average distance between trees in Panorama units, subject to a limit of three trees per triangle. At 
Recursion Levels 4 or 5 this is not too serious a limitation. The Tree Spacing at which the upper limit makes _ 
_ 4 difference is about 28 for Level 4 and about 9.4 for Level 5. All values between 0.0 and 2000.0 are 
accepted in the requester. 


Size 


The Tree Size is roughly the average height of the trees, though there are some differences specific to = 
Tree Type. The DFir trees will be a bit taller than their nominal size, and the AFir trees will be a bit smaller. 
Values between 1.0 and 1000.0 are accepted. The ratio of the Tree Size to Tree Spacing for a Contour should 
be about 2.0 or a little more to give the impression of a fairly dense forest. A ratio of 1.0 will give a fairly = 
open forest, with ground visible between the trees. Smaller ratios give wider scattered trees. 


Pixel Density | ia 


The fractal procedure that generates the trees scatters pixels on the screen, gradually filling in the tree 
image more and more densely. There is a tradeoff between having fully drawn trees with all the detail of the 
smaller branches visible and cutting short the fractal process with a corresponding saving in rendering time, 
particularly when the trees in the foreground are many pixels wide and high. The Pixel Density parameter is 
proportional to the number of pixels devoted to a tree at some standard distance from the camera, and is set cat 
separately for each Contour. The range accepted is 0.1 to 10.0, with the default value of 1.0 giving fairly 
well filled in trees. There is no point in making the Pixel Density so large that almost all of the pixels being 
drawn are on top of other pixels belonging to the same tree. 


Leaf and Bark Texture 


The Leaf and Bark Textures function in the same way as the Contour Texture as far as the amplitude 
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of the brightness fluctuations is concerned, but there is no “dither pattern” to choose, since the pattern of 
brighter and darker pixels is set by the fractal process that generates the tree. The range of integer values 

accepted is 0 to 32. The texture values are set separately for the Cliffs and the Contours independently of 
how colors or Tree Types are assigned. 


Making Waves 


What would lakes be without ripples? What would oceans be without waves? What indeed. Panorama 
can put waves in, where you want them, how you want them to look, and with maximum control over all of 
the possibilities. You can even animate the water, if you want. 


The ‘Waves’ Requester 


The ‘Waves’ Requester gives you maximum control over how water looks in Panorama pictures. It’s 
not just for waves. It’s the “water department,” too. After all, you might want, not waves, but a placid, 
refecting pool. 
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_ Wave Type and Water Texture 


Panorama offers a variety of options for rendering water surfaces. At the simplest, the water is drawn 
as a completely uniform, “Water” color on flatter parts of rivers, lakes, and (in Amiga rendering) the sea, or 
the “Sea” color in 24-bit rendering of the sea or the sea ground plane. (Turn water and sea dither off in the 
“Water’ submenu of the ‘Features’ menu, which overrides any Wave settings.) 

With water and/or sea dither on, there is a choice of ‘Wave Type,’ either in the ‘Wave’ submenu of the 
‘Features’ menu or by cycling through the options with the ‘Wave Type’ button in the ‘Waves’ requester. 
Turning off Waves entirely with ‘None’ means the water color will be uniform in a given picture (except for 

“dithering associated with texture), but will vary with the angle of elevation of the sun, brightening as the 
elevation angle increases. In Amiga rendering dithering is used to interpolate between the discrete levels of 
brightness possible with pure colors, with a choice of ‘smooth’ and somewhat ‘rougher’ texture according to 
whether the Water or Sea Texture is in the range 0-32 or 33-64. In 24-bit rendering, as with Contours and 
Cliffs, the number within each range determines the amplitude of brightness variations within the dither 
pattern. The Water and Sea Textures can be changed with the ‘Wat Tex’ and ‘Sea Tex’ gadgets, respectively. 

The default ‘Sheen’ wave type varies the brightness of the water surface in a random fractal pattern 
over distances several times the triangle edge length of the current Recursion Level. The effect is intended to 
model variations in the brightness and texture associated with varying amounts of rippling of the water 
surface from puffs of breeze, as seen from a distance. Individual ripples and waves are not resolved. It is 
quite effective when the camera is looking over a large expanse of the landscape from a substantial height of 
a few hundred or more Panorama units. The ‘Sheen’ wave type renders quickly, too. 

The third Wave Type option is ‘Waves.’ Real ones. Here Panorama offers a great deal of control over 
the patterns and shapes of “real” Waves modeled as a “bump map.” That is, variations of brightness and 
color are used to give the illusion of three-dimensional Waves, without requiring elaborate calculations to 
model and project the Waves out of the plane of the water surface. Panorama lets you choose the 
fundamental Wavelength without regard to the size of the landscape triangles, since in the real world the 
sizes of Waves are very small compared with the sizes of landscape features such as hills and mountains. 
This also means that in order to resolve the Waves, even in the foreground, given the limited number of 
pixels on the computer screen, the camera must be placed down close to the water surface. Waves are visible 
in either normal Amiga or 24-bit pictures, though they will look much better in 24-bit pictures. 

Depending on how the pattern is resolved, on its complexity, and on how much of the picture is 
waves, the “Waves’ option can greatly increase the rendering time. If speed of rendering isa primary 
consideration, stick with the ‘Sheen’ option. However, truly spectacular 24-bit pictures are possible with 
Waves and Sky Reflection turned on and with the hi ighest possible density of pixels to resolve as much of the 
Waves as possible. ‘Sky Reflection’ adds a strikingly realistic, shimmering water surface. 


Lake Waves 


By default ‘Waves’ or ‘Sheen’ will be applied to water surfaces on both lakes and the sea. However, 
you have the option of turning lake Sheen and Waves Off with the ‘Lake Waves’ gadget in the ‘Waves’ 
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requester. The Water Texture will still be applied to the lakes, but there will be no other brightness variations 
on the lakes. The Waves or Sheen on the sea remain in effect. Note that it is not really practical to make the 
size of Waves realistically small on a lake occupying just a few landscape triangles 


Sky Reflection 


The “Sky Reflection’ button affects Waves in 24-bit pictures only. With both Sky Reflection and true 
Waves ‘On,’ a calculation is done for each pixel of the 24-bit picture to determine the angle the line of sight 
associated with that pixel makes with the Wave surface and the angle the reflected ray makes with the 
horizontal. The water/sea color (with brightness modified according to the angle the Wave surface makes 
with the direction to the sun) is mixed with the sky color appropriate to the elevation angle of the reflected 
ray. The sky color (interpolated between the horizon color and the Sky Zenith color) is dominant when the 
ray from the camera is nearly tangent to the wave’s surface. The water/sea color is dominant when the ray 
from the camera is nearly perpendicular to the wave’s surface. The effects can be remarkably realistic. The 
camera should be close enough to the water surface to resolve the Waves in the foreground, and it is best 
when the water or sea color is rather dark, to emphasize contrast with the reflected Sky. The color of the sky 
reflection takes on the hue of the horizon color in the distance. Incredible sunset effects are quite possible. 


Number of Waves 


The ‘# Waves’ text gadget allows you to vary the complexity of the Wave pattern. The larger the 
number of Waves the more interesting the wave pattern and the less apparent any large scale regularity due 
to dominance by just a few Waves, but the longer the rendering time. The default number is 10—about the 
minimum to give a reasonably random-looking pattern. Values between 1 and 32 are accepted. The Waves 
used to construct the Wave pattern consist of one “Main Wave,” which can be separated from the other 
Waves in amplitude and Wavelength using the ‘Amp! Contrast’ parameter, and from 0 to 31 subsidiary 
Waves, amplitude proportional to Wavelength, which extend to shorter Wavelengths the more there are. 


Wave Seed 


The seed used for the random number generator in generating Sheen and Wave patterns can be altered 
by entering a custom seed in the ‘Wave Seed’ text gadget. Any value between 1 and 2147483647 is 
accepted. By default, the Wave Seed is equal to the Fractal Seed. 


Sheen Amplitude 


Applies only to the ‘Sheen’ Wave Type. Vary the amplitude of the brightness variations in the ‘Sheen’ 
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pattern with the ‘Sheen Amplitude’ text gadget or slider in the ‘Waves’ requester. The default value of the 

Sheen Amplitude is 0.25, and the allowed range is 0.0 to 2.0. By default, the slider range is 0.0 to 1.0. The 

apparent amplitude of the Sheen variations will be somewhat larger in 24-bit rendering than in Amiga 

rendering, and the default value works well for the 24-bit rendering. _ 


Wave Amplitude 


This parameter applies only to the ‘Waves’ Wave Type. It varies the amplitude of the Waves, which 
affects both the brightness variations associated with the angle of the Wave to the sun and any shadows cast = 
by the Waves and the pattern of sky reflection when ‘Sky Reflection’ is On. The larger the amplitude the 
Steeper the Waves. The default value is 0.1, with an allowed range of 0.0 to 1.0. The Sky Reflection works 
best when the Wave Amplitude is fairly small--at the default value or less--and therefore the default slider 
range is 0.0 to 0.2. The Wave amplitude corresponds roughly to the maximum slope of the Wave form of a 
single Wave, so with a large number of Waves the maximum slope of the superimposed Waves will be 
several times this. A larger amplitude might be appropriate if you set the ‘# Waves’ to only 1 or 2, anda 
smaller amplitude if you go for broke with a ‘# Waves’ of 20 or 30. 


Wave Size 


The ‘Wave Size’ sets the scale of the Wavelength of the Waves in Panorama units. The nominal 
fundamental full Wavelength is 2 times this number. The Main Wave has a longer Wavelength by an amount 
set with the ‘Amp! Contrast’ parameter, and the remaining Waves, if any, have shorter Wavelengths. 
Remember that unless the camera is fairly close to the water, Waves of realistically short Wavelengths will 
not be resolved. The default value is 20.0, a compromise between realism and visibility. The default slider 
range is 5.0 to 25.0, with smaller values in this range good for Level 5 landscapes, and larger values being 
more suitable for Level 4 landscapes. The “legal” range is 0.1 to 1000.0. 


Amplitude Contrast 


This parameter is labeled ‘Amp! Contrast’ in the Waves requester, but is set with the 
“Main WaveContrast’ Picture Script or ARexx command. The exponential of the parameter is the ratio of the 
Main Wave amplitude to the nominal ‘Wave Amplitude,’ which is the same as the ratio of the Main Wave 
half- Wavelength to the ‘Wave Size’. That is, the ratio of amplitudes is about 2.7 when the Amplitude 
Contrast is 1.0 and about 7.4 when the Amplitude Contrast is 2.0. The default slider range is 0.0 to 1.0 and 
the legal range is 0.0 to 2.0. 

Larger values for Amplitude Contrast make the Main Wave act as an ocean swell, which is not so 
noticeable in a single picture compared with the shorter Waves, but becomes apparent as it moves through 


ee ag a ee 


78 ©1993 Push*Button Publishing 


the shorter Waves in an animation. The default value is 0.0, in which case the Main Wave has an amplitude 
and half- Wavelength equal to the ‘Wave Amplitude’ and ‘Wave Size,’ respectively, and just contributes to 
—— the general Wave field. 


Wave Shape 


The ‘Wave Shape’ parameter allows the Waveform of an individual Wave to be varied, from being 
symmetrical between crest and trough like a sinewave, with a value of 0.0, to having a sharp crest and a 
broad trough with large positive values. Values in the range of -6.0 to 6.0 are allowed, with negative values 
giving broad crests and sharp troughs. Sharp crests is the tendency of real Waves under the action of wind or 


a shallowing bottom near shore. The default slider range is 0.0 to 4.0. The default value of 3.0 gives 
~~ moderately sharp crests. 


Main Wave Position 


Panorama’s Waves have circular Wavefronts centered on points which are distributed randomly, 
except for the Main Wave whose center can be located as you choose with the ‘Main Wave X’ and ‘Main 
Wave Y’ text gadgets in the Waves requester or with the corresponding Picture Script/ARexx commands. By 
placing the Main Wave center properly relative to the camera position you can control the direction of 


movement of the ‘‘ocean swells” in an animation. The text gadgets accept values in the range -9999.0 to 
— 9999.0. 


Wave Phase 


If you’re drawing a sequence of frames, Waves can be animated by varying the ‘Wave Phase’ value in 
the “Wave Phase’ text gadget, which Panorama will “tween” for you, so all you have to do is enter a value 
for each keyframe. Increasing the Wave Phase makes the Wave crests move outward from their respective 
Wave centers at speeds which vary with Wavelength in the same way as real water waves, the longer waves 
moving faster. The nominal fundamental Wave, whose Wavelength is twice the ‘Wave Size,’ goes through 

~~ one complete cycle of oscillation from crest to trough back to crest at a given location as the Wave Phase 
changes by 360 (degrees). The actual phases of the shorter Waves change more rapidly than this, since their 
shorter Wavelengths more than compensate for the slower speeds of their Wave crests. The change in the 

__ ‘Wave Phase’ from one frame to the next in an animation should be no more than a degree or so to get 
smooth motion for the shorter Waves as well as the longer Waves. You can set the Wave phase in the range 
-9999.0 to 9999.0. 
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The ‘Haze’ requester 


Haze is produced by mixing the ‘Haze Color’ with the landscape or sky color at each pixel, by an 
amount depending on the path length through the haze. Panorama lets you set an elevation, the ‘Haze 
Height,’ above which the haze is absent. If the ‘Haze Height’ is below the observer, a large value for the 
“Haze Density’ produces spectacular ‘fog’ effects, with mountaintops clear and valleys filled with mist. All 
haze effects are only visible in 24-bit pictures. Use the ‘Convert To HAM’ option to view them. 


Haze Type 


The “Haze Type’ button in the ‘Haze’ requester allows toggling among three options. A Haze Type of 
‘None’ (equivalent to a ‘HazeType 0’ Script command) turns haze off without having to fiddle with the Haze 
Density parameter. “Type 1’ haze is the “realistic” option. The fraction of the landscape or sky color that 
survives decreases exponentially with the path length through the haze. The coefficent in the exponential is 
the ‘Haze Density’ divided by 8000.0, so the haze is begins obscuring the landscape substantially for a path 
length of 8000.0about the diameter of a landscapewhen the ‘Haze Density’ is 1.0. For ‘Type 2’ haze, the 
term in the exponential is the Haze Density times the square of the ratio of the path length to 8000.0. The 
effect is to make the foreground clearer and the distant landscape more heavily obscured. “Type 1’ haze is 


the default and can be used either for conventional haze effects with the camera below the top of the haze or 
for fog effects with the camera above the haze. 


Haze Height 


Haze Height is the absolute elevation of the top of the haze. When the camera is above this height the 
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sky and the portions of any mountains sticking above the top of the haze are completely clear of haze. Any 

os part of the landscape below the top of the haze is obscured by an amount which depends on the Haze 
Density and the path length from top of the haze to the surface of the landscape along the line of sight from 
the camera. When the camera is below the top of the haze, the Haze Height affects the amount of 

=~ obscuration along a line of sight directed upward, such that the sky will approach the haze color near the 
horizon. The default Haze Height is 1000 Panorama units, while the range of the slider is from the height of 
the lowest point in the landscape to 1000 units above the observer or above the highest point in the 
landscape, whichever is lower. Numbers from -8000.0 to 200000.0 can be entered in the text gadget. 


Haze Density 


The Haze Density parameter controls how the amount of haze obscuration varies with the path length 
through the haze. For conventional haze effects when looking across a large part of the landscape, the Haze 
Density should be less than or on the order of 1.0. The default value of 0.3 means none of the landscape 
proper will be heavily obscured, though if part of the ground plane is visible behind the landscape it will be 
heavily obscured in the distance, since the path length gets infinitely long when the line of sight approaches 
the horizon. For fog effects, the Haze Density should be increased to much larger values, since the path 
lengths from the top of the haze to the landscape surface will usually be rather small compared to the 
distance across the landscape. The ‘Thin Fog’ and ‘Thick Fog’ values set in the ‘Haze’ submenu of the 
‘Features’ menu are 10.0 and 25.0, respectively. Legal values are in the range 0.0 to 100.0. 


The ‘Sky’ requester 


In 24-bit rendering the sky can be drawn as a blend of colors, varying from the Horizon Color near the 
horizon toward the Sky (Zenith) Color looking straight up. The interpolation between the two limiting colors 
iy can be done in one of three different ways, according to the choice of Horizon Type. How rapidly the 
horizon color approaches the Sky Zenith Color as the angle of elevation of the line of Sight increases is 
specified by the Horizon Height parameter. The Horizon Type can also be set in the ‘Sky Horizon’ submenu 


Sie ot ee ne” Gn ne a ee 
Panorama version 3.0: Picture Perfect Fractal Landscapes 81 


of the ‘Features’ menu. The closest 12-bit approximation to the Sky Zenith Color is the sky color used in 
normal Amiga rendering. The colors should be set using the Colors requester. Try a sunset picture with the 
horizon color a shade of orange or red and the Sky Zenith color a dark blue. The actual colors in the picture 
may modified by the Haze color, at least near the horizon, and also depend on the Sun Contrast parameter. 


Horizon Type a 


The “Horizon Type’ button toggles between ‘None,’ in which case the Horizon Color is not used, and 
three alternative types of interpolation between the horizon color and the Sky Zenith Color, labeled ‘RGB,’ 
“‘HLSRGB,’ and ‘HLSRBG.’ 

In the ‘RGB’ type, the interpolation is done linearly in the familiar R, G, and B values, and the color 
space is a cube. If the horizon color is a complement of the Sky Zenith Color, i.e., yellow when the Sky _ 
Zenith Color is blue or red when the Sky Zenith Color is cyan (equal amount of green and blue), the RGB 
interpolation will pass through a shade of grey. The RGB interpolation is probably the most “realistic,” and 
is the default. 

The other two types are based on a different kind of color space, known as “Hue - Luminosity - 
Saturation,” or HLS. The Hue can be thought of as an angle with, say, blue at 0 degrees, red at 120 degrees, 
and green at 240 degrees. Interpolation between the horizon color and the Sky Zenith Color in Hue goes 
around the color wheel rather than through the center grey value. The results can be impressive, if a bit 
garish when the colors are too saturated. The types differ in the direction in which the interpolated colors 
march around the wheel. The ‘HLSRGB?’ type goes from red to blue through shades of yellow and green, 
while the ‘HLSRBG’ type goes from red to blue through shades of magenta. = 


Horizon Height 


The Horizon Height parameter determines how rapidly the horizon color approaches the Sky Zenith 
Color going upward from the horizon. The allowed range, and the range of the slider, is 0.0 to 1.0. The 
smaller the value the more rapid the transition. For the value 1.0 the weighting of the Sky Zenith Color is 
just the sine of the angle above the horizon. Since the field of view of the camera often will not extend more 
than 20 or 30 degrees above the horizon, the Horizon Height should be fairly small if the sky color is to 
begin approaching the Sky Zenith Color at the top of the picture. The default value is 0.3. 


The ‘Clouds’ requester . = 


The clouds in Panorama pictures are derived from a special kind of fractal surface whose “hei ght” is 
translated into cloud density, with a threshold below which the sky is clear. The parameters in the ‘Clouds’ > 
- requester allow you to squeeze, rotate, and shift the cloud pattern, vary the threshold to change the fraction 
of the sky covered by clouds, make solid clouds with sharp edges or thin, diffuse, cirrus-like clouds. The 
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clouds are two-dimensional, located on a cloud plane which should always be above the observer; otherwise, 
the clouds will be invisible. 


Clouds On/Off 


Toggle the clouds with the On/Off button in the ‘Clouds’ requester, just as you can by selecting the 
‘On’ item in the ‘Clouds’ submenu of the ‘Features’ menu. They are On by default. However, it does take a 
significant amount of time to draw the cloud pattern, which is done after the landscape proper is rendered, so 
you may want to turn Clouds off when experimenting with other aspects of the rendering. 


Cloud Seed 


The random number generator is used to generate the cloud pattern, which is primed with the Cloud 
Seed just before cloud rendering begins. By default, the Cloud Seed is the same as the Fractal Seed, but you 
can enter any other value in the range 1 to 2147483647 into the text gadget in the ‘Clouds’ requester. 
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-Cloud Size 


Set the horizontal scale, roughly a characteristic half- Wavelength, of the cloud pattern, though the _ 
Waves used to generate the cloud pattern are carefully chosen so the pattern won’t have any simple 
periodicity. Of course, the cloud pattern is seen in perspective, so the apparent size on the sky will vary with 
distance, and the clouds will be foreshortened along the line of sight. The default value is 10000.0, giving 7h 


rather large cloud structures; the default range of the slider is 2000.0 to 10000.0, and the legal range is 100.0 
to 40000.0. 


X/Y Ratio 


The inverse of the Cloud X/Y Ratio is the factor by which the clouds are stretched along the y-axis of 
the cloud coordinate system. By default the cloud y-axis is in the same direction as the the landscape y-axis, 
but a non-zero Orientation Angle will rotate the cloud axes relative to the landscape axes. Stretching in the 
cloud y-direction can be used to create long cirrus streamers, and, if the camera is pointed in the direction of a> 
the cloud y-axis, counteract the tendency of foreshortening to squash the clouds perpendicular to the 
horizon. The default value is 0.5; the default slider range is 0.0 to 1.0, and values are accepted between 0.0 
and 2.0. 


Amplitude Contrast 


The Cloud Amplitude Contrast controls to what extent the clouds will tend to line up in rows because 
of the Waves whose superposition makes the cloud pattern, the Waves with Wave fronts parallel to the y-axis 
have larger amplitudes than the Waves oriented in other directions. The ratios of the Wave amplitudes scale 
as the exponential of the Amplitude Contrast. The default value is 0.5; the slider range is 0.0 to 1.0, and the 
legal range is 0.0 to 2.0. The Picture Script/ARexx command for setting this parameter is ‘CloudContrast’. 


Threshold 


The Cloud Threshold controls the fraction of the sky covered by clouds. Large negative values will 
make clouds cover most of the sky, while large positive values reduce the cloud cover to a small fraction of 


the sky. The default value is 0.0, with a slider range from -1.0 to 3.0. Values from -5.0 to 5.0 are accepted in 
the text gadget. 


Fuzziness 


The Cloud Fuzziness parameter determines how rapidly the cloud “thickness” increases away from 
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the edge of the cloud. The larger the value the more slowly the thickness increases on average. Small 
thicknesses are rendered as a dithered mixture of the Thin Cloud Color and the sky color, getting to a solid 
Thin Cloud Color as the thickness increases to moderate values; then the Thin Cloud Color gradually blends 
into the Thick Cloud Color as the thickness becomes large. Experiment to get a feel for how this works. The 
dithering at small thicknesses is done in either Amiga or 24-bit rendering, but the rest of the thickness 
variations are apparent only in 24-bit. The default value is 1.0; the default slider range is 0.0 to 4.0, and 
values from 0.0 to 20.0 are accepted in the text gadget. 


Height 


The Cloud Height is the height of the “cloud plane” in Panorama coordinates. This height is used in 
calculating the projection of the clouds into the field of view of the camera. The lower the height the larger 
the clouds will appear and the greater the foreshortening perpendicular to the horizon. No attempt to draw 
the clouds is made if the Cloud Height is less than or equal to the Observer height (ObsZ, value). The default 
value is 4000.0. The default slider range is 2000.0 to 10000.0, and values from 1000.0 to 20000.0 are 
accepted in the text gadget. 


Cloud Center Position 


The whole cloud pattern can be shifted in any direction you like by entering new values for the 
coordinates of the center of the cloud pattern relative to the landscape coordinate system in the “Center X’ 
and ‘Center Y’ text gadgets. These values are tweened in a Picture Script, making it easy to make dramatic 
“time-lapse photography” animation sequences, with clouds streaming across the sky. The default values are 
both 0.0. Values from -99000.0 to 99000.0 are accepted. 


Orientation Angle 


The whole cloud pattern can also be rotated about its center. This gives you freedom to orient the 
stretching along the cloud y-axis as you like relative to the camera view direction. An increasing Orientation 
Angle rotates the cloud pattern in the same direction that an increasing View Direction angle rotates the 
camera, i.e., clockwise looking down on the landscape. The Picture Script/ARexx command is 
“CloudAngle’. The default value is 0.0, and values from -360.0 to 360.0 are accepted. 


Strategies 


Suppose Contour 5 is considered a ‘snow’ Contour, Contour 3 is a ‘forest? Contour, and Contour 4 
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represents the rocky terrain above treeline but below the snowline. Since snow tends to accumulate in gullies 
(also known as avalanche chutes) below the nominal snow line, it is appropriate to make the Slope Blending 
and Curvature Blending parameters positive at the 4-5 Contour boundary. On the other hand, the treeline 
tends to be higher in sheltered valleys, so you may want to make both of these parameters negative at the 3-4 
boundary. To make the ridges above snowline bare, the Cliff Curvature Bias parameter should be positive. 

By making the Top Height of Contour 4 greater than 1.0, you can use the Slope Blending and 
Curvature Blending parameters to make patches of snow at higher elevations in the landscape without 
having any solid snow. This might be desirable with a hilly landscape of relatively low relief. 

Note some of the tricks used in DEMSet files included with USGS DEM quadrangles to model such 
things as glaciers, or meadows in a valley floor. ~ 
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SECTION VI: 
Advanced Navigation 


The coordinate system 


Although you can do quite well operating Panorama through its graphical user interface without 
thinking much about coordinate systems and labels, an understanding of the coordinate systems used to 
define the position of the camera, as well as the labels used to identify points in the landscape will help you 
take full advantage of all the options. Such a knowledge and understanding, is essential for manipulating the 
camera position with Picture Scripts and ARexx macros. 

In Panorama, the coordinates of a point in the three dimensional space of the landscape measure 
distance from an origin at the center of the landscape along mutually perpendicular x and y axes horizontally 
and along a vertical z-axis from a more or less arbitrary zero point usually about halfway between the 
minimum and maximum elevations in the landscape. The camera is positioned and its view direction chosen 
using the physical coordinates. On the other hand, the vertices of the triangles that make up the landscape 
are labeled by two integers i and j which are proportional to the horizontal coordinates of the vertices in a 
way which depends on the Recursion Level. The physical, horizontal coordinates of a given point in the 
landscape do not change as the Recursion Level is increased, but the labels assigned to that point do. 

In Panorama, x,y,z form a right-handed coordinate system. The x-axis points toward the North and 
the y-axis points toward the West. The origin is adjusted vertically to make the average height of the vertices 
of the first triangle of the landscape, at Recursion Level 0, identically 0. Depending on the choice of fractal 
parameters and the luck of the draw, the final landscape may have heights skewed to predominantly positive 
or predominantly negative values. Distances are normalized so that at the end of Recursion Level 1 the 
triangle edges (projected into the horizontal plane) are 2000 units long and the left and right (South and 
North) corners of the landscape are at x = -4000.0 and x = 4000.0, respectively. At higher Recursion Levels 


the landscape has a roughly circular shape, with a radius of about 4500 units. The triangle edge length 


decreases by a factor of 3 with each increase in Recursion Level. At Recursion Level 4 the edge length is 
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2000/27 = 74.1 units, and at Recursion Level 5 the edge length is 2000/81 = 24.7 units. 

For a landscape containing a few large mountains it is appropriate to think of the unit of distance as 
about 1 meter or 1 yard, but it is really just an arbitrary scale. A typical landscape constructed with the 
default settings of the fractal parameters and vertical scale has heights ranging between about -1000 to 1000, 
which using the meter scaling corresponds to a range of about 6500 feet, certainly a bit more dramatic than 
typical places on the Earth’s surface. 


Labels 


Some of the ARexx commands need to refer to particular points in the landscape. This is done with 
labels, as opposed to coordinates. At a given Recursion Level, the landscape is stored as the heights of 
discrete points laid out in a regular grid as projected into the horizontal plane. The points are the vertices of 
the triangles which make up the landscape. The triangles as projected into the horizontal plane are 
equilateral triangles, with one side atigned with the x-axis. The ARexx commands which manipulate 
individual points identify the points using integer labels i,j which are proportional to the x,y coordinates of 
the points. The scaling factors depend on the Recursion Level. 

For Recursion Level n, let q = 3 to the power (n-1). That is, q = 1 for Level 1, q = 3 for Level 2,q=9 
for Level 3, q = 27 for Level 4, and q = 81 for Level 5. Then the x-coordinate of a triangle vertex is related 
to the label i by 


x = (1000.0/q)*i a 
and the y-coordinate is related to the label j by 
y = (1732.1/q)*j 


Both the x and y coordinates of the location of the mousepointer and the labels of the nearest 
landscape point when the pointer is over the landscape are displayed at the top of the Control Window when 
the graphical camera positioning mode has been activated by clicking on the map display with the left 
mousebutton. The i value changes by 2 from one point to the next along each row of points, and j changes 
by 1 from one row of points to the next. 

The points are staggered in the x-direction, so only odd values of i are used when j is odd and only 
even values of i when j is even. The labels i and j associated with a given point in the landscape each 
increase by a factor of 3 when the Recursion Level is increased by one. The point at the center of the 
landscape always has i=0, j=0, so near the center the (i,j) labels are: 
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3.) Ci (1) G1) 
Z (-4,0) (-2,0) (0,0) (2,0) (4,0) 
(3-1) (¢L-1) (1-1) @-1) 


The maximum value of j is 2 for Level 1, 7 for Level 2, 22 for Level 3, 67 for Level 4 and 202 for 
Level 5. The maximum values of i vary from row to row and are largest for j close to 0, when they are a 
little less than twice the maximum j. The general expressions for Recursion Level n can be written using the 
number q defined above. The maximum j is (Sq-1)/2. Between j = 2q and j = (5q-1)/2, the maximum i is 
9q-3j-1. Between j = (q-1)/2 and j = 2q, the maximum i is Sq-j-1. The maximum i alternates between 
(9q-3)/2 and (9q-1)/2 for j <(q-1)/2, with the maximum i equal to (9q-1)/2 at j= (q-1)/2. The pattern is 
symmetric about j=0 and separately about i=0. 





Figure 1 shows the layout of a Level 2 landscape. The solid lines outline the triangles present at Level 
1, the points added in the first round of Level 2 are indicated by ‘+’ symbols, and the dotted lines are the 
new triangle edges after the second round of points are added to complete Level 2. Labels are given for a 
few points around the edge of the Level 2 landscape. The point that had the label (4,0) at Level 1 has the 
label (12,0) at Level 2, and will have the label (36,0) at Level 3. 
a 
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SECTION VII: 
Animation 


Picture Scripts and ARexx Macros 


Using picture scripts or ARexx macros it’s easy to convince Panorama to create a whole series of 
pictures which can then be animated by single-frame recording, by page-flipping or by compressing them 
into an Amiga “Anim” format for display with standard animation programs. The latter can be done most 
efficiently if the animation program also has an ARexx interface--for example ASDG’s Morph Plus program. 
With ARexx control on all sides, a single ARexx macro could control both Panorama and the animation 
program, telling Panorama to create the next picture in the sequence and save it, and then telling the 
animation program to load the picture and add it to the “Anim” file. 

You could also simply save all the pictures to disk(s), and then operate the Anim file maker program 
on them, tweaking as necessary. 


Making and using Picture Scripts 


Picture Scripts are useful for creating a series of pictures in “batch” mode, generally for animation. 
You can create a picture script in several ways. First, you can use Panorama’s menus and requesters 
interactively, to create a script “on the fly,” as you perform the necessary operations in the program. The 
resulting script can then be edited to your needs, or used as is. Instead of “recording” your script, you could 


. also type the commands into any Amiga text editor capable of creating a standard ASCII text file. The 


system editor, “ED,” will work fine for this purpose. 
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Automatic script recording 


To create a picture script interactively (the easy way, if you’re just getting to know the program), iad 
select “Make Pic Script’ from the ‘Actions’ menu. Enter the path and create a filename for the script in the 
file requester. The extension “.scrpt” is added to the filename automatically. 

Click ‘OK! or press <RETURN> when the filename text gadget is active, to open the picture script 
file. The current Settings parameters will all immediately be written to the file, as though you had selected 
“Save Settings.’ This becomes the starting point for the Picture Script. Although it’s best to set up the 
program for the first picture you want drawn before entering Picture Script mode, there is no harm in 
changing the initial settings right off the bat, before entering your first ‘DrawPic’ command. 

All Control Window menuitems that don’t relate to Picture Script commands are ghosted until you exit 
the script-making mode. 

To continue making your script, just operate Panorama. For each picture you want drawn by the 
Picture Script, make any changes in the Settings you desire using any of the unghosted menu selections and 
the requesters they invoke. The corresponding commands are automatically entered into the Picture Script as 
you go. If you change your mind about something, just set it up again, the way you wantyou can edit the a 
script later to get rid of anything you don’t want, too. When you have a picture set up the way you want, or 
when you’ve changed any parameters that you want to animate (more on this shortly), select ‘Draw Picture’ 
from the ‘Actions’ menu. Doing so enters the command to draw the picture into the script file. 

At any time during Picture Script creation, if you wish to preview a picture to verify that it is framed 
properly, select ‘Draw Preview.’ This does not enter any command into the script file. 

After you have completed the sequence of operations you want performed, terminate the scripting 
process by selecting ‘Quit’ in the ‘Actions’ menu. When you’re creating scripts, the ‘Quit’ selection tells 
Panorama you’re done with the script, although this would normally would close the program altogether. In 
script mode, this menuitem only closes the script file and resumes normal operation. (Choose it again if you 
wish to quit the program.) , a 

Panorama implements a special “language” of commands for Picture Scripts, so if you want to edit 
the file, or add some special things that aren’t available from the pulldown menus (like tweening), you’ll 
need to become familiar with the commands. All of Panorama’s Picture Script commands are described in 
Appendix F, 

On account of its ARexx support, Panorama can also be controlled algorithmically with ARexx 
programs (“macros”), so creating a Picture Script isn’t the only way to get animation frames (or automatic 
operation of the program). ARexx commands and Picture Script commands overlap. The picture script 
commands are a subset of the ARexx commands. 


Executing Scripts 


To begin execution of a picture script, select ‘Exec Pic Script’ from the ‘Actions’ menu. A file = 
requester will appear asking for the name of the script file. Select a directory and a filename. The filename 
must have a ‘.scrpt’ extension. When you click ‘OK!,’ there will be a few seconds delay while the initial 
———-_ eee 
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rendering settings are read from the file, and then a ‘Script Setup’ requester will pop up. This allows setting 

a number of switches interactively which would otherwise require a text editor to insert in the script. These 
ere switches are mainly useful for animations, and are discussed in the ‘Picture Script Switches’ subsection. To 
proceed with the script, click “OK;’ click ‘CANCEL’ to abort. To abort the execution of a picture script later 
on, press <ESC> while a picture is being drawn. 

When a script file is generated by the automatic process in Panorama, each ‘Draw Picture’ command 
you issue from the pulldown menu is written into the script as ‘DrawPic’. Pictures are saved to files with the 
same filename as the script, but with the ‘.scrpt’ extension replaced by the number of the picture in either 
alphabetical or numerical format (according to the ‘Pic Order’ setting in the ‘Switches’ menu when the script 
file is executed). The first picture has an extension “‘.0001” if the ‘Pic Order / Alphabetical’ subitem in the 
‘Switches’ menu is checked, or “.1” if the ‘Pic Order/Numerical’ subitem is checked. 

Most animation programs require picture files in alphabetical order (e.g., DeluxePaint), so that 001 
= comes before 002, and 111 is before 23. However, some require filenames be in “numerical” order, without 

leading zeros. Panorama defaults to alphabetical. 


Tweening 


Creating a Panorama Picture Script using the menus and requesters can get tedious if you need a 
really large number of frames. Animations can be set up much more easily using “tweening.” The frames 
explicitly recorded into the script with ‘DrawPic’ commands are regarded as keyframes. Normally, only 
these specific frames are drawn. However, with the Picture Script requester that appears when you select 
“Exec Script’ in the ‘Actions’ menu or with a ‘Tweens [n]’ command inserted with a text editor at the 
beginning of the script, you can tell Panorama to generate [n] pictures between each pair of keyframes. The 
number of tweens can be adjusted at any point in the script by inserting “Tween [n]’ commands with 
__ different values for [n]. The command ‘Tweens 0’ turns tweening off. 

The following of Panorama’s parameters are interpolated linearly between their the previous (if any) 
keyframe and the current keyframe for each of [n] intermediate frames: 

A. the Vertical Scale of the landscape; 

B. the fractional sea level; 

C. the ‘Elevation Angle’ of the sun; . 

D. the ‘Field of View’ (i.c., the inverse of the camera focal length); 

E. the X,Y coordinates of the observer’s position; 

F. the observer height, either as an absolute height following an ‘ObsZ’ command or as a relative 
height above the landscape following a ‘RelObsZ’ command; 

— G. the X,Y,Z coordinates of the view target when in ‘Target’ mode as set either explicitly or implicitly 
through a “TargetX’ ‘TargetY’ or “TargetZ.’ command; otherwise, the ‘ViewDir’ and “VertViewAngle’ angles; 
H. the ‘Bank Angle’ of the observer’s field of view; 
_ I. the ‘Sun Contrast’ and ‘Shadow Contrast’ parameters; 
J. the ‘Wave Phase’ value; 
K. the ‘Horizon Height’ parameter governing the transition from the horizon color to the sky zenith. 
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color; - 

L. the ‘Haze Density’ and the ‘Haze Height’; 

M. the coordinates of the center of the cloud pattern, as set with the ‘CloudXPos’ and ‘CloudYPos’ 
commands. : 

The value of [n] can be from 0 to 499, and the maximum number of frames in the animation is 9999, 
At video’s 30 frames per second, that’s close to 6 minutes. If you need more... make several scripts! The 
maximum number of scripts is limited by infinity, which isn’t much of a limitation. 


Picture Script Switches 


In a Picture Script the ‘DrawPic’ command, which should have no argument, triggers the drawing of 
any tween frames and the current keyframe. The numbering of the picture filenames is done automatically, 
according to the ‘Pic Order’ setting (Alphabetical or Numerical as indicated by the checkmark in the 
submenu of the ‘Switches’ menu) in effect when the script is executed. Some other switches can be set in the 


‘Script Setup’ requester that opens automatically just before the script is ready to execute the first ‘DrawPic’ 
command. 


Save Enabled 


The options for ‘Save Enabled’ are ‘Yes’ (the default) or ‘No’. With saving turned off, the pictures will 
not be saved to a file, but will still be drawn and displayed on your monitor. 


Draw/Save Switch 


The ‘Draw/Save’ switch has four options, ‘Preview’ ‘16/32’ ‘HAM?’ and ‘IFF24’. The defaults are 
‘16/32’ if 24-bit is off at the beginning of the script or ‘IFF24’ if 24-bit is on. If you select ‘16/32’ 24-bit is 
turned off, normal Amiga pictures as set up by ‘DrawMode’ ‘ShadingType’ etc., commands are drawn and 
(with Save enabled) saved as ILBM files. On the other hand, by selecting ‘Preview’ you can do a quick 
wireframe run-through of the animation to be sure that the framing and sequencing of the pictures is 
satisfactory. When saved to files the Preview pictures take up relatively little memory, and compress well 
when converted to an Anim, so a fairly large animation can be stored and then played back in Deluxe Paint, 
for instance. If you select ‘HAM’, 24-bit is turned on, each picture is converted to a HAM display, and (with 
Save enabled) saved as in ILBM file. If you select ‘IFF24’, 24-bit is turned on and (with Save enabled) the 
pictures are saved as 24-bit IFF files. 
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HAM Palette Switch 


The ‘HAM Palette’ switch gives a choice between a ‘Free’ and a ‘Fixed’ HAM palette. When in the 
‘Free’ mode the palette (the 16 colors which can be set directly at each pixel) is optimized separately for 
each picture. However, in an animation it is desirable, and may be required, to have the same palette 
throughout an animation. A ‘Fixed’ HAM palette keeps the palette the same as the last HAM picture, if any, 
that was drawn. If fixing the palette at the start of the script, you should have drawn a picture with the same 
landscape and similar rendering settings just before, unless you know that no other HAM pictures have been 
~ drawn since you booted up Panorama. 


Blurring Switch 


The ‘Blurring’ switch functions in the same way as the “Blurring On’ item in the ‘Project’ menu in the 
picture screen. This affects only 24-bit and HAM pictures, smoothing sudden transitions in color from one 
pixel to the next when the option is turned On. 


2 Tweens 


Finally, you can set the number of tweens. Set Tween values low to do rough testing, and adjust them 
— higher when you make your final pass. 

Everything in the ‘Script Setup’ requester can be altered at any point later in the script by inserting 
appropriate commands in the script, using a text editor. Enable or disable saving with ‘StartSave’ and 
*“StopSave’ commands. Switch in and out of preview mode with ‘StartPreview’ and ‘StopPreview’, 
“StartHAM’ or ‘StopHAM? and ‘FixHAMPalette’ or ‘FreeHIAMPalette’. Turn blurring on and off with 
“BlurringOn’ and ‘BlurringOff’, and turn 24-bit on or off with ‘24bitsOn’ and ‘24bitsOff’. These commands 
are discussed in the ‘Draw Commands’ subsection of Appendix F. 


Viewing animations 


Numerous programs will run animation directly from Amiga ILBM pictures saved by Panorama. You 
can use Digital Creations’ DCTV display enhancement device to animate your landscapes in a much higher 

— color resolution (approximately 2 million colors). Just use the DCTV software’s conversion options to make 
DCTV-format pictures out of your 24-bit Panorama pictures, and then use the DCTV pictures to create an 
ANIM file. Any number of public domain and commercial programs will compress the pictures into an 
Anim file. The star of these is Morph Plus. ASDG’s Art Department Professional also has the ability to 
convert Panorama’s 24-bit files to the enhanced display modes of the Ami ga 4000’s “AA” chips. It’s a good 
choice for finetuning the brightness, contrast, and color bias of 24-bit pictures, as well as HAM and other 
Amiga-displayable resolutions. 
a ee 
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Art Department Professional will also permit incorporating text, even in 24-bit pictures, even if you 
don’t have a 24-bit-capable display board. 


Housekeeping 7 


The ‘HidePic’ script command means that a picture screen is opened during execution of a script 
behind any other screens present. This command is also available from the pulldown menus. It is present so 
operation of other programs can continue unimpeded while Panorama draws its pictures in the background. 
Using the ‘HidePic’ command might also speed up the drawing of the pictures if the front application is a 
relatively simple one. ‘ShowPic’ restores normal display of the pictures as they are drawn. = 
In Picture Scripts, continuous real variables, such as the camera’s position and the sun’s elevation 
angle, can be specified as increments from the previous values if you like. Just put the letter “I” immediately 
in front of the number by which the variable is to be incremented. Example: “‘ObsX 1200.0” means te 
increment the observer coordinate by 200.0 units from the previous value. If you’re changing the variable by 
the same amount each time, this can save a lot of typing and manual calculating when working with a text 
editor, though using Tweens will be more convenient for most people. 
The command ‘End’ terminates execution of a picture script file, no matter where you put it in the file. 


Animation ideas - 


The most natural kind of animation to attempt is a flyover or other aerial acrobatics around a 
landscape. In such an animation, the changing perspective greatly enhances the 3D feel of the landscape. a 
Unfortunately, there are severe problems with achieving this kind of animation. For one thing, smooth 
animation requires many frames. Another big problem is that standard delta-compression schemes are not 
very effective when a large portion of the pixels changes from one frame to the next--as they do when the 
observer moves over a landscape. The result is that even a short animation will be huge, and can only be 
played, let alone constructed, on an Amiga with large amounts of memory. 

To minimize the size of an animation you can try drawing the pictures in the low-res, non-interlace 
draw mode (Draw Mode 1). This degrades the resolution of each image, but drastically reduces memory 
requirements. The loss of resolution is not nearly so noticeable when the landscape is in motion as it is ina 
still picture. 

Another problem with a moving observer is “pixel crawl” or “jitter,” which is particularly noticeable > 
when there are sharply contrasting colors (e.g., snow and rock) on adjacent landscape triangles and these 
triangles comprise only a few pixels. As the observer moves, individual pixels suddenly change brightness 
as the projected positions of the triangles change. The problem is worst for the more distant parts of a Level _ 
‘5 landscape, when the projected triangles contain only 1 or 2 pixels. The ‘Blurring’ option can reduce the 
sudden color contrasts in 24-bit or HAM pictures. True antialiasing would help even more, but it would 
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greatly increase the rendering time and is not implemented in this version of Panorama. Increasing the 
screen resolution also helps, by giving more pixels per triangle. This method imposes a memory penalty, as 
= well as increasing the rendering time, but it’s there if you want to try it. 

Another possible solution is to decrease the value of the picture ‘Resolution’ parameter (Select 
‘Resolution’ from the ‘Features’ menu). A good place to start testing would be in the 0.5 or 0.6 range. This 
decreases the distance from the observer for which triangles are drawn in full resolution. More distant parts 
of the landscape are drawn with triangles of double the normal size in linear dimension, increasing the 
number of pixels per triangle by a factor of 4, (but also ignoring any rivers that may cascade down distant 
mountainsides). 

A type of animation which compresses much better than a flyover is a sunrise or sunset animation. 
The only thing changing from one frame to the next is the elevation angle of the sun. Even here, however, 
the fancier shading modes reduce the effectiveness of compression, resulting in large animation files. 
Wireframe renderings (Draw Mode 5) should compress quite well since the colors change only at the edges 
of shadows. A scene with a lot of water to show off the shadows of the mountains can be quite dramatic in 
wireframe. 

_ ' Yet another type of animation to try is one in which a rising sealevel floods a river valley. This should 
also compress well. 

You can also animate the water, as mentioned previously, by changing the ‘Wave Phase’ to make the 

€- Waves move from one frame to the next. For this motion to be smooth the changes in phase from one frame 
to the next should be quite small, probably less than 1 degree. 

You can make clouds drift across the sky by varying the ‘CloudXPos’ and ‘CloudY Pos,’ giving an 
effect like time lapse photography. The change in perspective when the clouds are moving away from or 
toward the camera can be quite dramatic. 

One more animation idea... Vary the Vertical Scale to make hills transform into craggly peaks or vice 
versa, compressing eons of geological time into a few seconds. 

~— If the pictures you draw with Panorama are intended for single-frame film or video recording, some 
of these considerations are moot. You don’t have to worry about how compressible the 24-bit files are if the 
display medium is video or film. 
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. SECTION VIII: 
= ARexx 


oz ARexx is a powerful and flexible macro language which allows a diversity of programs to 
communicate with each other. It greatly extends the range and functionality of the multitasking of which 
Amiga computers are capable. The ARexx language must be installed and operating in your system in order 
for programs (and you) to use of it. Full ARexx functionality is included as part of AmigaDOS 2.0 and 
higher. Users with older versions of AmigaDOS can buy an ARexx package from Ami ga software suppliers. 
If all else fails, contact William S. Hawes, P.O. Box 308, Maynard, MA 01754, 617-568-8695. 

You don’t have to have ARexx to use Panorama. Having it gives you some advanced capabilities, 
however, both in Panorama and in other Amiga programs that are ARexx-savvy. Also, Panorama’s <F10> 
“demo” mode depends on ARexx. : 

ARexx programs can send commands to Panorama. In addition, Panorama can return data to the 
external program in response to a command. However, Panorama cannot be used to send ARexx commands 
to external programs. Panorama acts as an ARexx “server,” not as a “host.” 

ARexx commands allow almost all operations in Panorama to be controlled externally, without user 
interaction. Landscapes can be generated, parameters can be changed, pictures can be drawn and saved to 
disk. About the only things that are not accessible through ARexx are making and executing picture scripts. 
Some commands unique to ARexx allow heights in the landscape to be modified and additional permanent 
springs to added at any Recursion Level, not just Level 1. The ARexx commands which Panorama 
recognizes are described in Appendices F and G. 

Panorama will execute any of its individual ARexx commands even if ARexx proper is not installed 
in your system, if you issue the command using the ‘ARexx Command’ pulldown menuitem in the ‘Actions’ 
menu. A requester window appears with a text gadget into which you can type the ARexx command and its 
arguments. The “return code” and the “RESULT string,” if any, will be displayed in this window when 
execution of the command is finished. The window will remain open so you can easily enter a sequence of 

— ARexx commands. To make the window go away, click its Close gadget. You can leave the ARexx window 
open while you use the menus and gadgets on the Control Window, but remember to activate the Control 
Window by clicking in it with the left mousebutton before trying to access its menus. 
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ARexx commands are sent as a string consisting of the command keyword followed by a list of 
parameters separated by spaces. Do not use any punctuation to separate the parameters. Keywords are not 
case sensitive. Almost all Picture Script commands have ARexx counterparts, so check both the common 
commands in Appendix F and the purely ARexx commands in Appendix G for the appropriate syntax of 
each command and a description of what it will accomplish. 

Although you can send ARexx commands to Panorama in this manner without having ARexx 
running, you cannot by this means execute any other ARexx macros which address other programs--you 
need ARexx for that. 


Port Name 


Panorama’s ARexx port name is “Panorama’’. When firing up, Panorama checks to see if = 
“rexxsyslib.library” is present in your “‘libs:” directory. If so, it opens a public message port named 
*Panorama’ which can receive commands from ARexx macro programs. If you place the line “address 
*Panorama’ ” near the beginning of your ARexx macro, all subsequent commands not part of the ARexx 
language will automatically go to Panorama. 


Responses from ARexx Commands Ss 


ARexx sends a reply to the ARexx program once execution of a command is completed. This reply 
contains a “return code” which is accessible to the ARexx program through a variable, “RC.” The return ae 
code tells whether the command was executed, whether it was executed but in a modified form due toa 
parameter being outside the allowable range, and whether there was some “severe” problem (such as not 
having enough memory) which dictated stopping execution of the ARexx macro. If a command was not 
executed due to some error in the form of the command or because not enough memory was available, 
subsequent commands may produce unintended results. Be sure your ARexx macros check the return codes 
and take appropriate action, especially if the potential consequences of an error are serious. 

For some of the commands, values of variables are returned to the ARexx macro in a “RESULT” 
string (that is, a string variable with the name “RESULT”). When only a single number is involved, the 
“RESULT” can be directly assigned to an ARexx number variable in your ARexx script. When there is more 
than one number in the string, your ARexx macro can use ARexx’s ‘PARSE’ instruction to break the = 
RESULT string into its components (separated by spaces.) 

Please note that the RESULT string is returned only if the error code ‘RC’ is 0 and an ‘OPTIONS 
RESULTS’ command has been previously given from within the ARexx macro. 

The RC code and the RESULT string are shown in the ARexx Command window for ARexx 
commands executed from that window within Panorama. 
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Executing ARexx macros 


To run ARexx macros, you must have ARexx running--that is, the “rexxmast” program which 
initializes the ARexx system should be run either before or after starting Panorama. Amigas running 
AmigaDOS 2.0 or above accomplish this in their normal Startup-sequence. (AmigaDos 2.1 does not do this 
out of the box. You must move the “rexxmast” Program to your “WBstartup’ drawer or edit the 
startup-sequence appropriately to automatically run ARexx on startup.) For earlier versions of the operating 
system, you'll also need to implement this, either by clicking an icon in the ARexx contro! drawer that 
comes with the ARexx package, or by installing the ARexx utilities correctly in the AmigaDOS system and 
calling them transparently in the machine’s startup-sequence. If you want to use the F6-F10 function keys 
for operating specially named ARexx macros from within Panorama, be sure that the rexxmast program is 
running BEFORE you start up Panorama. 

A macro with the name “F6.Panorama,” “F7 -Panorama,” “‘F8.Panorama,”’ “F9.Panorama,” or 
“F10.Panorama” which is either in the directory from which Panorama was run (this is the directory in 
which Panorama is located if you start Panorama from its icon or the directory of the Shell window at the 
time Panorama was started by entering the command “run Panorama” (without the quotes) in a Shell 
window) or in the system REXX: directory will start automatically when the corresponding function key is 
pressed and Panorama’s Control Window is active. The Panorama distribution disk contains one such 
macro, named ‘“‘F10,Panorama,” which will indefinitely generate and draw pictures of a series of fractal 
landscapes. Write your own macros to accomplish such chores as sending Panorama pictures to your 


favorite animation utility or toa program like Art Department Professional for conversion to special formats, 
or look for them on bulletin boards. 


For more extensive use of ARexx, and especially for initially checking and debugging your own 
ARexx command scripts, you’!l need to have a CLI or Shell window open on the Workbench screen. Use the 
front/back gadget in the top right corner of Panorama’s Control Screen, or the Left-Amiga-N key 
combination, to move back to the Amiga Workbench and multitask your ARexx development operations. To 
start an ARexx macro from this window, type “rx <macroname>”. The program ‘rx’, which should be in 
your C: directory, interprets your macro and sends its commands to the “rexxmast” program. This same 
Shell window also serves to receive any output from the ARexx macro and any error messages from the 
ARexx system. 

For example, to execute a macro with the filename “test.rexx”’ in the current directory for the Shell, 
enter the command “‘rx test” in the window and press <RETURN>. 

If “rexxmast” is running when Panorama is started, a window with the title “Rexx-Panorama” will 
open on the Workbench screen to receive output and input from macros associated with the F6-F10 function 
keys. This window cannot be used as a Shell window to initiate ARexx macros. It will remain open as long 
as Panorama is running, and close automatically when you quit Panorama. If a function key macro requires 
input, you will need to flip to the Workbench screen (Right-Amiga-N) and type the data into this window. 

While an ARexx macro is executing Panorama will not respond to any attempts to use the Panorama 
menus or gadgets. 
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Pressing <ESC> while an ARexx command is executing will usually cause a return code of 30 to be 
returned when the command is finished. The ARexx macro can take this as a signal to abort. 

If the ARexx macro ends with a picture being displayed, you can gain access to the Control Window 
and its menus by pressing <F5> or the <HELP> key or by clicking with the left mousebutton on the picture 
screen. While the picture screen is in front of the Panorama Control Window, all key strokes and other input 
will go to the Control Window, so you need to toggle the Control Window to the front in order to use any 
other window. 

Do not try to multitask Panorama with itself. It refuses to permit more than one of itself in a system, 
in order to prevent confusion with its ARexx port and macro functions. 


ARexx Return Codes 


The return codes and their general meanings are: 

‘0’ -- command executed successfully, no problem, 

‘S” -- a warning that a parameter of the command was outside the recommended range, but was still 
acceptable. The command was executed in its original form. 

“10” -- the command was executed in an altered form, usually because one or more of the parameters 
of the command was outside the acceptable range and was changed to an acceptable value. 

“20” -- the command was aborted. Either the syntax or a value of one or more of the parameters passed 
was incorrect or some error condition occured during the execution of the command. As much as possible 
the state of the Panorama program is left as it was before the command was sent. Normally this return code 


should be considered a fatal error in the execution of the macro, but it can be ignored in some 
circumstances. 


«30” -- execution of the macro should be unconditionally stopped. Low memory problems or the state 
of Panorama make continued execution pointless, or the user signalled that the macro should terminate by 
pressing <ESC> during the execution of the previous command. 

In case of more than one type of error, the highest error code is returned. An incorrect command 
keyword will not be recognized at all, and no return code will be sent. 


Interaction with Panorama during execution of a Macro. 


When creating a series of pictures with a Picture Script or an ARexx Macro, the previous picture may 
in some circumstances be displayed while the preliminary calculations for the next picture are going on. If 
for some reason you want to abort execution of the Script or macro, you don’t have to wait until the next 
picture starts rendering. Just click the picture with the left mousebutton. This brings the Control Window to 
the front. With the Control Window active (title bar not ghosted), clicking on the Close gadget of the ‘Busy’ 
window will immediately stop calculations of the shadow values or the brightness values. If lakes are being 
filled (only relevant for ARexx macros) you can click ‘EXIT’ or ‘EMPTY’ in the Lakes requester to stop the 
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lake filling process and leave the lakes partially full or empty. This will generate a Return Code of 10 to the 


‘Lakes’ command, but execution will proceed normally with the partially filled or unfilled lakes unless the 


macro program acts on the Return Code or you take further action. You can bring back the picture screen 
back by pressing <F5>. . 


There is no way to interrupt the calculations for a new Recursion Level. 


If you press <ESCowhile a picture is being drawn, the ARexx macro will receive a ‘RC’ return code of 


30 from the ‘DrawPic’ command, but might not terminate unless the macro checks the return code and 
responds accordingly. 
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= SECTION IX: 
- About fractals 


What is a fractal? 


Many things in nature cannot be said to have any one characteristic size or length scale. Rather, they 
have a similar kind of structure over a wide range of scales. Coastlines have peninsulas and bays, capes and 
inlets, on scales from hundreds of kilometers to tens of meters. Trees have branches ranging from large 
limbs to small twigs. The word “fractal,” coined by Benoit Mandelbrot, denotes this “regular complexity,” 
in which the structure over a range of scales is similar in form, usually (in nature) with random variations. In 
_ the real world the range of scales over which the form is similar is always finite, but in the ideal world of 
mathematics one can imagine the fragmentation of structure to extend over an infinite range of scales. 

Mandelbrot discusses many kinds of fractals, both natural and mathematical, in his classic book The 
Fractal Geometry of Nature. For some excellent articles on the nuts and bolts of creating and displaying 
fractals with computers, see The Science of Fractal Images, edited by H.O. Peitgen and D. Saupe. 
Particularly relevant to fractal landscapes are Chapter 1, “Fractals in Nature,” by R. F. Voss, Chapter 2, - 
“Algorithms for Random Fractals,” by D. Saupe, and Appendix A, “Fractal Landscapes Without Creases 
and With Rivers,” by B. Mandelbrot. Panorama’s basic algorithm for Creating its fractal landscapes was 
taken from Appendix A. 

One of the simplest examples of a fractal, and one which is closely related to the fractal rivers in 


<< Panorama, is the von Koch curve. To construct the curve, start with a single straight-line segment from A to 
B: 


A B 


Call this the Level 0 curve. Now split this segment into thirds, and replace the middle segment by a 
detour to the left around the sides of an equilateral triangle: 
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A B 


This is the Level I curve. For each straight segment of this curve, replace the middle third by a detour 
to the left around an equilateral triangle: 


AY TA 8 


This is the Level 2 curve. 

The same process can be continued indefinitely. The von Koch curve is the limit in which there are an 
infinite number of subdivisions. 

Let the length of the initial Level 0 segment be one unit. At Level 1 there are 4 sements each of length 
1/3, for a total length of 4/3. At Level 2 there are 16 segments, each of length 1/9, for a total length of 16/9 = 
(4/3). How rapidly the length increases with the level of subdivision is related to the fractal dimension D of 
the curve. 

If n. is the length of an individual segment and Nx is the total number of segments at Level k, then Nk 
is proportional to (1/n)D. For the von Koch curve, D = (log(Nk+1/Nx))/(og(ti/re+1)) = (log 4)/(log 3) = 
1.2619. 

How can the fractal dimension of a river in the real world be measured? Suppose you have a highly 
detailed topographical map (or series of maps on different scales) showing all the bends and wiggles of the 
river. Take a compass (the kind used to draw circles) and set the distance between its points to the distance 
on the map representing an actual distance of 32 miles, say. Set the pivot point of the compass at the source 
of the river and find the farthest point downstream on the river which is intersected by a circle drawn by the 
compass. Move the pivot point of the compass there and repeat the process until you reach the mouth of the 
river. Count the number of 32 mile segments measured this way, N32. Reset the spacing of the points of the 
compass to correspond to 16 miles. Repeat the process, finding the number of 16-mile segments along the 
river, Nie. Similarly, find Ng and Ng. The river can be said to approximate a simple fractal if the ratio Nie/N32 
is about the same as the ratio Ne/Nis, and so on. The fractal dimension would be the logarithm of this ratio 
divided by log(2). With a real river the subdivision process cannot be continued indefinitely, since at some 
point the distance scale becomes comparable to the width of the river. At best, a real river only approximates 
a fractal over a limited range of length scales. 
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Fractal Surfaces and Landscapes 


The von Koch curve is a particularly simple kind of fractal, called a self-similar fractal. When all 
lengths are rescaled by an appropriate factor, any small piece of the curve looks exactly like a large piece of 
the curve. However, a landscape surface does not twist and turn on itself in three dimensions the way the 
von Koch curve twists and turns in two dimensions. The landscape surface (neglecting rare overhangs) has 
an unique height at each horizontal point. 

The simplest mathematical model of a random fractal landscape is called fractional Brownian motion 
by Mandelbrot. The surface can be thought of as a sum of an infinite number of sine waves oriented in all 
possible directions, with random phases, such that the average amplitude of the waves scales as a power of 
— the wavelength. The amplitudes of the waves get smaller as the wavelength decreases, but the steepness of 

the waves, as measured by the ratio of amplitude to wavelength, gets larger. Thus what on large scales may 

be a gently rolling surface looks jagged and rough on very small scales. The surface is not self-similar, like 
aes the von Koch curve, but self-affine. That means that the structure of the surface on small scales is 
statistically similar to the structure of the surface on large scales only after the heights have been rescaled by 
a different factor than the rescaling of the horizontal dimensions. 

The fractal dimension is not as easily defined for a self-affine surface as it is for a self-similar curve. It 
is possible to break up the surface into polygons (triangles, say) of various sizes, and see how the area of the 
polygonal approximation to the surface varies with the size of the polygons. However, the area does not 
scale as a simple power of the linear scale of the polygons. On large scales the polygons are nearly flat and 
the area of the surface is essentially the same as the area of the flat projection into the horizontal plane, 
differing only in the square of the (small) ratio of the amplitude of the height fluctuations to the horizontal 
size of the polygons. The scaling of the area reflects the simple power-law scaling of the fractional Brownian 
a motion wave amplitudes only when the surface is subdivided into very small polygons, with vertical 
dimensions large compared with their horizontal dimensions, so the area is linear in the amplitude of the 

height fluctuations. The horizontal scale at which the amplitude of height fluctuations is comparable to the 
horizontal scale is called the crossover scale. 

The usual “practical” definition of the fractal dimension of a set of points in three-dimensional space 
is based on splitting the space up into many cubes of size r. For a given cube size, find the total number of 
cubes N(r) containing at least one point of the set. If N scales as a power of r, then this “grid” fractal 
dimension D, is defined by: 


Dg = log(N2/N)) Aog(ri/r2) 


That is, N is proportional to r. Unfortunately, for fractional Brownian motion surfaces, N scales as a 
power of r which corresponds to the scaling of the amplitude of the height fluctuations only on scales that 
are small compared with the crossover scale, while real landscapes generally approximate a fractal only on 
scales larger than the crossover scale. Real landscapes are not very rough on small scales, and an attempt to 
measure D, would find a value close to 2 regardless of the actual fractal properties of the landscape. 

re 
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Amore appropriate definition of a “fractal dimension” for landscapes is what I call the affine fractal 
dimension D.. Imagine rescaling all the heights in the landscape by a factor F>>1, so the rescaled surface is 
very rough on all scales of interest. Measure the grid dimension of the vertically rescaled surface, and 
identify this as the affine dimension of the original surface. ; 

A practical scheme for directly measuring the affine fractal dimension of a surface with a unique 
height z at each horizontal point (x,y) is to lay down a horizontal grid of N cells, either squares or triangles, 
of size r. = 

Find the range of heights h; of points in the surface within the ith cell, and calculate the sum of the h; 
over all the cells. This sum scales as (1/r) to the power (D,-1) over a range of scales r for which the surface 
approximates a simple fractal. The number of cells, i.e., the number of terms in the sum, scales as (1/r). 

Another aspect of the fractal properties of a surface is the variance between heights of points 
separated by a fixed horizontal distance r. 


According to the normal definition, the variance of heights of points separated by a horizontal 
distance r is 


Vit) = Sqrt(<(z(x,y)-2(x oy 0) )?>) 


where the angle brackets mean average over all horizontal positions xo,yo and x,y such that the 
distance of separation is a fixed value r = Sqrt((x-xo)*+(y-yo)). For fractional Brownian motion, V(r) 
increases as a power of r, r', and the quantity H is related to the affine fractal dimension D, by D, = 3 H, as - 
long as 0<H<1. In the sum over sine waves, only waves with wavelengths less than or comparable to r 
contribute to V(r) as long as H is substantially less than one, though wavelengths much larger than r 
dominate this “Type 1” variance in the limit H=1. 

The variance V(r) is the conventional definition in the literature on fractals. However, it is not a good 
measure of the amplitude of the fluctuations on the scale of the separation r when the fractal dimension is 
Close to 2. Consider, for instance, a mountain produced by fluctuations on large scales. Unless the 
mountainsides are quite rough, the height differences on small scales will be mainly due to the overall slope 
of the mountainsides, and V;(r) will increase linearly with r regardless of how the actual small-scale 
roughness is scaling with r. 

A much better measure of the roughness under these circumstances is the “Type 2” variance defined 
by 


Va(r) = Sqrt( <(z(x+r) + z(x-r) - 2*z(x))?> ) = 


Here x represents a point in the horizontal plane (the reference point), and r represents a (vector) 
displacement from that point whose magnitude is r. 

The three points xr, x, and x+r are evenly spaced along a line. When the slope is uniform, the 
contribution to V2(r) from a steep mountainside is zero, so V2(r) is only sensitive to the local roughness on 
the scale r. The variation of the Type 2 variance with r is a much better measure of the fractal character of a 
landscape than that of the Type 1 variance in practice, though for ideal fractional Brownian motion both 
scale as the same power of r, r", as long as 0.0<H<1.0. 
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Variance calculations 


In Panorama, the “‘GetVariance [filename]” ARexx command calculates both Type 1 and Type 2 
variances for a number of separations r. For each type of variance the results are displayed for different 
directions of the displacements and for an average over all the directions as described here. 

If H>1.0 as measured by the Type 2 variance, the surface is locally smooththat is, has a normal 
dimension of 2. If H<0 the surface is so rough on small scales that it does not even have a well-defined 
height at a point and has a fractal dimension of 3. A “normal” fractal surface has a well-defined height but 
not a well-defined slope at a point and has 0<H<1, or 3>D,>2. The quantity V2(r) is easy to calculate for a 
computer-generated surface or from measurements of a real landscape, as a test of how well it approximates 
fractional Brownian motion and as one measure of fractal dimension. Note that the quantity H measures 
only the relative amplitude of fluctuations on large and small scales, and its value is independent of where 
the crossover scale is in relation to the range of r over which V(r) is measured. 


Algorithms for fractal landscapes 


The ideal of fractional Brownian motion can only be approximated on the computer, since the 
computer can only calculate a finite number of waves or points. The closest approximation to fractal 
Brownian motion can be achieved by modeling the surface as a finite sum over waves spanning a finite 
range of effective wavelength, using discrete Fourier transforms, or various kinds of random noise functions. 
These methods tend to be computationally intensive, but have produced striking pictures relatively free of 
numerical artifacts. An alternative is to lay out grids of points in the horizontal plane, increasing the number 
of points and decreasing their spacing in discrete Stages. At each stage either all or just the new points are 
given random vertical displacements. These kinds of point displacement methods are very easy to implement 
and have been widely used in computer graphics, including such movies as Star Trek II: The Wrath of Khan. 

The simplest versions are random edge midpoint displacement algorithms. For instance, lay out a grid 
of equilateral triangles with sides of length L. 

The heights at the corners of the triangles are given. Add new points at the midpoints of the triangle 
edges, and set the height of each new point to the average height of the two adjacent corners plus a random 


increment. Connect the new points to create a new grid of triangles with edge lengths of L/2, as shown in 
Figure 2. 
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Figure 2. Edge midpoint displacements. “ 


> 

Repeat, reducing the amplitude of the random increments by the same factor (between 1.0 and 2. 0) at 
each new stage. Note that the new heights along a given line of triangle edges in the landscape are 
completely unaffected by how the landscape develops away from that line. This allows “creases” to develop 
in the landscape which can be quite noticeable to the eye as numerical artifacts. The creases can be reduced 
by giving all the old points random increments along with the new points at each stage (“successive random 
additions’”’). 

Tile midpoint displacement methods add the new points at the center's of the triangles (or squares), 

The new polygons are not nésted in the old ones, but instead overlap them, which makes the height of a new 
point respond to developments in neighboring triangles and suppresses the worst numerical artifacts. 

The basic algorithm of Panorama is of this type, based on equilateral triangles, and is described by 
Mandelbrot in The Science of Fractal Images. Reconnecting across the old triangle boundaries at the edges 
of the landscape is handled by adding new points to expand the landscape, which tends to make the 
landscape roughly circular at high Recursion Levels. az 

The random fluctuation for a new point is added to a reference height, which is normally the average 
of the heights of the three corners of the surrounding triangle. To give more flexibility in designing 
landscapes, the reference height can be biased upward or downward (Upward Bias parameter), and the 
amplitude of the random fluctuations can be enhanced at high elevations (Relief Bias parameter) and (if the 
High/Low option is in effect) suppressed at lower elevations, simulating the tendency of erosion to dissolve 
mountains and deposit sediment in valleys. Old points can either be left alone or (Jiggle On) given a random 
increment in height along with the new points at each stage. Leaving the old heights unchanged allows some 
. artifacts to appear in the form of spires or pits, but these can add drama to the landscapes. 

With each new round of adding points the triangle edge lengths in Panorama decrease by a factor of 
1/Sqrt(3) and the height fluctuation amplitude is decreased by a factor of 1/(Fractal Index). The Fractal = 
Index must be greater than 1.0 for the heights to converge to finite values at infinite recursion level, and less 
than Sqrt(3) = 1.732 for the typical triangle steepness to increase indefinitely with Recursion Level so that 
that the fractal dimension of the surface is greater than 2. Ideally, for a large number of subdivisions, the 
affine fractal dimension of the surface is: 


D. =3 Log(Fractal Index)/Log(1.732) 


nig 
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For creating simulations of real landscapes all of these methods, and the ideal of fractional Brownian 
motion which they attempt to approximate with varying degrees of success, have a severe failing. Although 
they can give mountains and valleys, the valleys are not organized into coherent drainage systems. 
Landscapes on Earth, at least, evolve through a combination of uplift and erosion, both occuring 
simultaneously, and the major river systems tend to maintain their courses in spite of the uplift of mountain 
ranges. In The Science of Fractal Images, Mandelbrot discusses some attempts to incorporate rivers into the 
structure of fractal landscapes, but the river networks are frozen into regular patterns. 

The novel aspect of Panorama is that realistic-looking rivers, valleys, and river networks are 
generated randomly along with the landscape. Springs are sprinkled over the landscape at the beginning of 
each new Recursion Level with a density which is controlled by thé’ Spring Probability established by the 
user. Rivers are run from the springs, following the paths of steepest descent along the triangle edges until 
they reach a local minimum in the landscape, the edge of the landscape, or run into an already existing river. 


The first order of business when adding a round of new points to the landscape is to add points along the 
rivers. 





Figure 3. Adding river points. 


In Figure 3 the dots are the old points and the plus-signs are the points added in the first round of the 
new Recursion Level. Suppose part of the path of a river at the old Recursion Level is from A to B to CtoD 
to E. At the first round of adding new points the AB segment can wiggle left through either of the points 
labeled a, the BC segment through either of the points b, and the CD segment through either of the points c, 
and the DE segment through either of the points d. The simplest version of the rivers algorithm makes the 


choice of wiggling left or right for each segment completely random, which is the case with the Meander 
Slope parameter set to zero. 
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When the Meander Slope parameter is non-zero, the ratio of the actual slope of a segment like CD 
(which is just downstream from a bend in the old river course) to the Meander Slope parameter is used as a 
measure of how strongly to weight the wiggling probability to the outside of the bend, through the point ¢ on — 
the left of the old river path. The probability is still 50-50 if this ratio is less than 1.0, but becomes 100 
percent the left point c, when the ratio is much larger than one. If there is no upstream bend, as for segment 
BC, the probability of wiggling left or right is always 50-50. 

Choosing the left point c makes the river as straight as possible locally, given that it is forced to 
wiggle one way or the other by the tile midpoint algorithm. This actually maximizes the overall meandering. 

To see why, note that the BC segment may wiggle right. Then if the CD segment also wiggles right, the next 

stage of the subdivision process may see the river cut off its meander and shorten itself by going through the 
midpoint of triangle Coc. Also, note that if the meanders do not cut themselves off, the length of the river 

grows as it is subdivided further at exactly the same rate as the von Koch curve, and therefore has the same 

fractal dimension. Panorama’s rivers are randomized von Koch curves, in that the von Koch curve is a me 
Panorama river for which the choice of wiggling left or right follows the set pattern of alternating between 
always wiggling left and always wiggling right at successive stages of the subdivision process. 

Once the new paths of the rivers are determined, and the new points on the rivers given heights 
randomly interpolated between the old upstream and downstream heights, the remaining triangle midpoints 
are added to the landscape. If a new point is adjacent to (but not on) a river, its height must be greater than 
the height of any point downstream from an adjacent river point. Thus, the height of the point b not on the 
river must be higher than the height of the point b through which the river flows. Point ¢ must be higher than 
the point downstream from point C. If the point b through which the river flows is adjacent to point ¢, point 
¢ must be higher than point C, rather than just point d. 

These constraints guarantee that if the river is rerun later it will keep to the path determined for it, a 
except for cutting off sharp meanders (a detour around two sides of an equilateral triangle is not the path of 
steepest descent) or (very rarely) the capture of one river by another. The range of the height fluctuations 
next to rivers is shifted upward, building the valley walls along the paths of the rivers with increasing 
refinement as the Recursion Level increases. When a stream runs right along the base of a mountain the 
result is often an impressive cliff. 

Panorama’s treatment of its rivers does not really simulate nature, since there is no attempt to 
explicitly model erosion, but it does mimic a river’s maintaining its course and grade by eroding down as 
fast as mountains rise around it on a geological time scale. Also, the relation of meandering to the slope of 
the river is qualitatively similar to that in nature. 


Calculating Fractal Properties 


You might be interested in exploring the fractal properties of your landscapes in more quantitative 
detail. To help you do this, Panorama provides a few extra ARexx commands which give the results of some 
Statistical sums and averages for the current landscape. The command syntaxes are given in Appendix B. fom 
T’ll describe here what the numbers returned by these commands mean in terms of the fractal properties of 
the rivers and the landscape. The numbers are dominated by statistical fluctuations at low Recursion Levels, 
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So go to as high a Recursion Level as possible> 


I’ve tried to keep the explanations non-technical, but in some cases a fair amount of mathematical 
background may be necessary for real understanding. 


GetRivLength 


Returns first, the straight-line distance from the permanent spring you specify to the end of the river in 

a lake or the edge of the landscape, and second, the distance along the river, following all the meandering. 

ae The effective fractal dimension of the river can be estimated by finding the distances D, and Ds along the 
river at Recursion Levels 4 and 5, preferably for a long river from a spring set at Level 1 and extending to 
the edge of the landscape. The fractional dimension estimate (only an estimate since the fractal dimension is 

Ets. strictly defined at infinite Recursion Level) is 1 + Log(Ds/D4)/Log(3). The length of a segment decreases by 
a factor 3 and the number of segments increases by a factor of 3 times the ratio Ds/Da4. Experiment to see 
how the fractal dimension depends on the Meander Slope parameter, the number of tributaries, and whether 
or not you rerun the rivers at each intermediate Recursion Level. 


NumberRivPts 


The total number N of points along all the rivers in the landscape. An estimate of the fractal dimension 
of the entire network of rivers in the landscape is Log(Ns/N4)/Log(3). This will depend on how the Spring 
=— Probability varies with Recursion Level and the average fractal dimension of the individual rivers. If the 


Spring Probability is constant, the effective fractal dimension may be greater than 2, though this could not be 
sustained to infinite Recursion Level. 


GetAreaRatio 


The area ratio A is the ratio of the actual area of the landscape present to the area as projected in the 
horizontal plane, including only the part of the landscape that would be present at Recursion Level 1. The 
effective fractal dimension based on area elements is 2 + Log(As/A4)/Log(3). This depends on the Vertical 
Scale of the landscape, and only approaches the affine fractal dimension (at a finite Recursion Level) when 
the Vertical Scale is very large, so all the triangles are very steep. 


a GetFractalDim 


A direct estimate of the affine fractal dimension of the landscape, based on the definition discussed 
earlier, with a result independent of the actual Vertical Scale of the landscape. The absolute value of the 
difference in height between the highest corner and lowest corner of each triangle is summed over all the 


= Oo eee 
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current-Recursion-Level triangles within the Level 1 portion of the landscape, and then divided by the 
corresponding sum for the triangles present at the next lower Recursion Level. The Log of this ratio, divided 
by Log(3), and plus 1, is the fractal dimension estimate returned by the ARexx command. It tracks the 
theoretical fractal dimension of 3 - Log(Fractal Index)/Log(1.732) fairly well, within statistical fluctuations. 


GetVariance + 


Creates an Amiga text file containing Tables of both Type 1 and Type 2 variances as defined 
previously. For each Type, the first set of columns of numbers, “Variance on principal axes,” compares a 
height differences between a reference point and points displaced along three lines through the reference 
point parallel to the triangle edges. The minimum spacing of the points is the triangle edge length in the 
Panorama grid. For the Type 1 variance, the height difference between each of the two points along these aa 
lines at the given distance r and the reference point is squared, and then the squares are averaged over a large 
sampling of reference points. For the Type 2 variance on principal axes, in the second set of Tables, the 
heights of the two points at the given distance r along the lines are summed, twice the height of the reference 
point is subtracted from the sum, and the result is squared and averaged over the sampling of reference 
points. The numbers tabulated are the logarithms (to base 10) of the square roots of the averaged square 
differences. 


The directions along the triangle edges are North-South (labeled N-S), 60 degrees East of North and _ 
120 degrees West of North (labeled ENE-WSW), and 60 degrees West of North and 120 degrees East of 
North (labeled WNW-ESE). Also tabulated are the numbers from the squared differences averaged over all 
three directions (labeled Average). 

The Tables titled “Variance halfway between principal axes” are similar, except that the lines along 
which the differences are taken are perpendicular to the triangle edges through the reference point. The 
spacing of the points along these lines is different from the spacing along triangle edges, with a minimum 
separation sqrt(3) times the length of a triangle edge. The directions of the lines are 30 degrees West of 
North and 150 degrees East of North (labeled NNW-SSE), 30 degrees East of North and 150 degrees West 
of North (labeled NNE-SSW), and West-East (labeled W-E). Again, the column labeled “Average” comes 
from the average of the squared differences over these three directions. The values of the point separation r 
(in the first column, labeled “‘r’’) are at each multiple of the minimum separation out to 5 times the 
minimum separation, and then at approximately uniform percentage changes in r. 

If the height field being sampled were an example of fractional Brownian motion, V(r) would be = 
independent of the direction of the displacement from the reference point, and V(r) would increase as.a 
constant power of r related to the fractal dimension, as already discussed. You can easily estimate this power 
by taking the difference of the logarithms of V(r) at two values of r and dividing by the difference of the 
logarithms of r. 


The fractally-generated Panorama landscapes which would be expected to most closely approximate 
fractional Brownian motion are those with Upward Bias and Relief Bias parameters set to zero, no rivers 


(Spring Probability zero at all Recursion Levels), and a Fractal Index the same at all Recursion Levels. 
However, particularly with “Jiggle Old” turned off, there are significant statistical differences in the 


a ee ts 
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variances about reference points laid down at low Recursion Levels and those about reference points laid 
down at high recursion levels. The visual evidence of this in the landscape is a tendency toward relatively 
sharp spires centered on the old points. Having “Jiggle Old” on during landscape creation makes the 
landscape statistically more uniform. : 

Even then V(r) is often not a particularly good power law at the smallest and largest spacings. The 
numbers at the largest Spacings will vary quite a bit from one landscape to the next because they depend on 
the random heights of just a few points created at a low Recursion Level. The average power law index may 
differ significantly from what is expected from the fractal dimension implied by the Fractal Index, mainly 
because the range of length scales in the landscape is finite. 

The deviations from fractional Brownian motion are not necessariliy good or bad, but something to 
explore and compare with other types of algorithms for creating fractal landscapes. Experiment to see how 
the presence of rivers and non-zero values of the other fractal parameters affects the variance. However, let 
your aesthetic judgement be the guide as to what are “good” values of the fractal parameters. 


Real Landscapes 


What about real landscapes? Can they be well approximated by fractals? And if So, what is the typical 
fractal dimension? Different studies have gotten rather different answers, depending on the regions 
examined and on the method of analysis. At least in some cases the variance seems to increase fairly rapidly 
with separation up to the order of one kilometer and then increase more slowly after that. indicating a fractal 
dimension which is close to 2.0 on small scales, but perhaps 2.5 or 2.6 or larger on scales more than a few 
kilometers. Rivers seem to have fractal dimensions of about 1.1 to 1.2 over scales up to a hundred 
kilometers or so. You can try to reach your own conclusions from experiments on simulating different kinds 
of landscapes with Panorama, but remember that fractal dimension refers to how the amplitude of 
fluctuations varies with scale, not to whether the surface is rough or smooth on a particular scale. 

Since Panorama is able to import USGS Digital Elevation Model (“DEM”) data, you will be able to 
explore the fractal properties of different kinds of real landscapes for yourself. Differences in the variances 
along different directions May say something about underlying geological structures giving preferred 
orientations of gullies and valleys, or, particularly at small separations, these may Say more about numerical 
artifacts introduced by the procedures used to scan and to determine heights from aerial photos, which is 
how most of the DEMs were produced. For instance, the Type 2 variance is often substantially larger at 
separations less than about 200-300 meters along N-S directions than it is along W-E directions. When you 
look at renderings of these DEMs with the sun in the South or the North, you can see regularly-spaced E-W 
corrugations which are obviously not present in the real landscapes. Even worse, much of the real structure 
on scales of less than a few hundred meters is smoothed away by the USGS processing of the data, even 
though the heights are Supposedly being determined every 30 meters. 
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_ one-degree DEM data, or focus on particular features at ma 


__ have installed Panorama on your system GeoRama will be ready to go. 


SECTION X: 
Importing DEM files 


The GeoRama program 


The GeoRama program distributed with Panorama will create Panorama data files from up to nine 
adjacent quadrangles of DEM (Digital Elevation Model) data. The DEM data will normally be taken from 
United States Geological Survey (USGS) DEMs for 7.5-minute or one-degree quadrangles, and must be 
imported into GeoRama via a special compressed DEM-IFF format. The DEM-IFF file structure follows the 
general rules for the Interchange File Format developed by Electronic Arts and Commodore. The ability to 
merge neighboring quadrangles and vary the size of the patch imported into Panorama means that you have 
great flexibility in deciding whether to view a large region, perhaps 60 or 70 miles across in the case of the 


ximum resolution. You can move the Panorama 
data patch along with the camera to create one continuous flyover of an entire mountain range. 


Getting started with Georama 


Before running GeoRama it is a good idea to copy the DEM data files you will be using to a RAMdisk 


or to a harddisk, if at all possible. This will make everything go much faster. At the very least, consolidate 
the DEM files onto one or, if you have two floppy drives, two floppy disks. GeoRama accesses all of the 


relevant DEM files repeatedly as it is building the Panorama data file, so disk swapping is likely to be most 


inconvenient. Like Panorama, GeoRama requires that the “req.library” be in your libs: directory. Once you 


Start the program by clicking on its 
icon from Workbench, or enter “run GeoRama” from a Shell window. 
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Quadrangle Selection 


GeoRama comes up on a custom hi-res, interlace screen with a column of button gadgets at the right 
edge. Click “New Quads” to start selecting quadrangles. A file requester appears asking you to select the 
first DEM file. All subsequent quadrangles must have a comer or an edge in common with the first one, 
which means up to eight neighboring quadrangles may be included. As quadrangles are selected, their 
filenames (stripped of the path and any filename extension) are displayed in the appropriate box on the 
GeoRama screen. The longitude and latitude of the southwest corner of each quadrangle are shown at the top 
of each box, at least for the quadrangles based on USGS data. Note that the display has South to the left and 
North to the right, which means that West is to the top of the screen and East is to the bottom. The USGS 
quadrangles are larger in the S-N direction, and fit on the screen more efficiently when oriented this way. 

The first quadrangle is always placed in the central box. The file requester then reappears. Select 
another quadrangle file, if you wish. If the new quadrangle is not adjacent to the first one or is not of the 
same type as the first one, an error message will appear saying “Wrong Quadrangle. Retry?”. If you select a 
file that has already been selected, the error message will be “Quad already chosen. Retry?’’. In either case, 
if you click “OK” in the error requester, the file requester will reappear. If you click the “CANCEL” button, 
you will abort the selection process and must start over from the beginning. If you do not want to select any 
more quadrangles, click the “Forget it” button in the file requester. You are then asked in a requester to 
confirm whether or not “Quadrangles (are) complete?”. If you respond by clicking on “NO” the file 
requester reappears. If you click “YES,” a second requester asks “Accept quadrangles?”’. This time, “OK” 
means the quadrangles will be read from the file and displayed on the screen. “CANCEL” aborts the 
selection process. The selection process terminates automatically if you choose 9 suitably adjacent 
quadrangles. 

One restriction applicable to the 7.5-minute USGS DEM data is that all quadrangles must come from 
the same “Zone” of UTM (for Universal Transverse Mercator) coordinates. Each zone covers 6 degrees of 
longitude, starting at 180 degrees west longitude. Zone 11, from 120W to 114W, covers the eastern half of 
California and all of Nevada, for instance. The UTM coordinates, which define the grid on which the DEM 
data is stored, are locally Cartesian within a given zone, but do not mesh in going from one zone to the next. 
The UTM y-coordinate essentially measures distance from the equator in meters, and the UTM x-coordinate 
increases from West to East going perpendicular to the “Central Meridian” of the zone, the line of constant 
longitude in the middle of the zone. Think of the familiar Mercator world maps, but with the Central 
Meridian playing the role of the equator. If this seems complicated, it is because one is trying to treat the 
curved surface of the Earth as a flat plane, something that can only be done approximately over a local 
region. 

The DEM height unit must be the same for all quadrangles in the group selected. This unit is one 
meter for almost all DEM data, but some 7.5-minute data have a height unit of one foot. GeoRama will 
automatically take this into account. 

In the case of one-degree DEM data, the spacing of the points in the W-E direction changes suddenly 
at 50 degrees North and at 70 degrees North latitude. Each group of subquadranges loaded at one time into 
GeoRama must have the same point spacing. All United States data for the contiguous 48 states falls into the 
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less-than-50 degrees latitude category, and most of the Alaska data is in the 50 degrees to 70 degrees 
category. ; 

An error during the selection process (such as selecting a file that is not a DEM file, or selecting a file 
for a quadrangle not adjacent to the first quadrangle selected, or selecting the same file twice) will bring up a 
requester with an appropriate error message. Click “‘OK” in the error requester to continue with the 
selection process, or abort by clicking “CANCEL.” 

When selection is completed successfully, the quadrangle(s) are drawn on the screen as Contour plots 
with 16 Contour levels, in the same order that you selected them. The quadrangles are sized to fit into a 1x1, 
a 2x2, or a 3x3 square array, using the smallest array and the largest quadrangle size possible and leaving 
gaps if the full array is not selected. The Contours are shades of green at the lower elevations, shades of gray 
at the higher elevations, and white for the highest two Contours. The greens and grays each cycle twice 
through the range of shades, from dark to light going upward. When successive points along a 
South-to-North (left-to-right) profile have the same hei ght, they are colored blue. This may indicate a lake or 
may just be a flat part of the landscape. 

A quadrangle is drawn on the screen, if possible, with a 1-to-1 correspondence between the DEM data 
points and pixels on the screen. If the quadrangle(s) will not fit on the screen with a 1-to-1 ratio, every 
second or third data point, as required, is drawn on the screen. Since the pixels are not quite square on a 
normal Amiga monitor, and the DEM data points may not be spaced evenly (though they do have a uniform 
30 meter separation both N-S and E-W for 7.5 minute quadrangles), the quadrangle will usually be 
somewhat wider in the E-W direction than it should be if drawn completely to scale. Note that a 7.5-minute 
quadrangle is not rectangular on the screen. This is because the quadrangle boundaries are lines of constant 
longitude or lines of constant latitude, but these are curved lines relative to the locally Cartesian UTM 
coordinates. The further the quadrangle is from the Central Meridian of the UTM zone, the more it is twisted 
relative to the UTM coordinates. The points on which the one-degree DEM data is stored are evenly spaced 
in latitude and longitude. 


Recursion Level 


You can adjust the Recursion Level for the Panorama data file by clicking the “+” and “-” buttons. 
The smallest Recursion Level allowed is 2, but normally one should stick to levels 4 or 5 for best results. At 
Level 5 the density of Panorama points is about equal to the density of DEM points when the Panorama 
patch is about 1 quadrangle wide in the E-W direction. Dealing with a Level 5 landscape in Panorama 
requires that you have more than 2, and preferably at least 4 megabytes of memory. 


Selecting a Panorama Patch 


To define a region to be made into a Panorama data file, click the “Select Region” button. Now as 
_ you move the mouse the ‘“‘Rel” (for relative, meaning in units of the spacing of the points in the DEM file) 
coordinate offsets at the mouse location are continuously updated in the upper right corner of the screen. 
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Move the mouse to where you want the center of the Panorama region to be, press the left mousebutton, and 

drag the mouse with the button down to size the region. While dragging the mouse, the E-W width in “Rel” 
coordinates is continuously updated. Only vertical motions of the mouse pointer affect the sizing. There is a a 
minimum size allowed, depending on the Recursion Level selected, at which the spacing of the Panorama 

points is about half the spacing of the DEM data points. There is no point to oversampling the DEM data by 

a large factor. The center of the patch must lie within one of the displayed quadrangles. The patch is allowed ~~ — 
to extend beyond the edge of the quadrangles to edges of the screen in all directions. The heights assigned to 
the Panorama points where there is no DEM data are slightly less than the minimum height within the 
selected quadrangles. 

Again, the “Rel” coordinates are scaled so the horizontal spacing of the DEM data points is one unit 
both E-W and N-S. One unit is a physical distance of 30 meters for 7.5 minute quadrangles and normally is 
an angular distance of 3 arc seconds for one degree quadrangles. The “Rel” coordinates are zero roughly at 
the SW (upper left) comer of the group of quadrangles selected. The “absolute” coordinates in the same 
units of this local origin are displayed in the title bar of the window while the Panorama region is being 
selected. The absolute y-value is measured relative to the equator for both types of DEMs and the absolute 
x-value is relative to the origin of the local zone for UTM coordinates or is the longitude in units of the W-E az 
point spacing for one-degree DEMs. For artificially constructed height data it is up to the creator of the data 
to decide how to choose an origin. — 

Knowing the absolute UTM coordinates of the center of the Panorama ‘patch allows moving the patch 
across the terrain in a controlled way even when the group of quadrangles selected changes. You can move 
the Panorama patch along with the observer when making an animation. 

Once you have the Panorama region selected to your satisfaction, exit region selection mode by 
clicking with the right mousebutton or by pressing any key on the keyboard. The “Relative” coordinates 
displayed are then returned to their values at the center of the Panorama region. 


Setting Springs 


The next step, if you wish, is to locate some springs. It is a good idea to put springs near the heads of 
significant valleys or where a valley enters the Panorama region if you want to be sure of having a river 
there when the landscape is rendered. To start the spring setting mode, click “Set Springs.” Click with the 
left mousebutton where you want each spring to be. A small circle is drawn at each such location, which 
must be within the Panorama region. As you move the mousepointer the “Relative” coordinates of the 


mousepointer are continuously updated in the upper right corner. Terminate spring selection mode by 
clicking the right mousebutton or pressing any key. 


At the conclusion of spring selection you are given the option of setting the initial depths of the rivers ae 
from the springs. The default is that-the rivers start with zero width when rendered in Panorama and 
gradually become “deeper” and wider going downstream from the source. However, if a major river enters 
the Panorama patch, it looks much more realistic to have the river wide right from the start. A requester me 
window appears for each spring in turn. It shows the number of the spring; you can scale the initial river 
depth by entering a number from 0 to 127. A large value means the river has its maximum width right from 
a 
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the start, while a small value means the river will get substantially wider going downstream from the spring. 
The overall width of all the rivers can still be adjusted in Panorama by setting the River Depth parameter in 
the ‘Features’ menu. If you press <RETURNowhile the string gadget in the window is active or click 
“MORE,” the requester for the next spring will appear, until initial depths have been set for all the springs. 
However, if you don’t want to bother with this past a certain point, and leave the remaining springs with the 
default zero initial width, click the “DONE” button. You can save time, therefore, by placing the Springs for 
the rivers you want to be wide first. The depth information will be placed in the Panorama data file along 
with the locations of the springs. 

If you make a mistake in placing the springs, just leave spring entering mode (by clicking with the 
right mousebutton or by pressing any key), and click on the “Select Region” button. This automatically 
erases all the springs, without resetting the region unless you click with the left mousebutton. Click with the 
right mousebutton to exit and then click “Set Springs” to start over. 

The only way lakes can be identified in the DEM data files is as regions where all the points have the 
same height. GeoRama slightly towers the heights of points within such regions so that Panorama will be 
able to fill them as lakes. However, some flat regions in the DEM data may just be flat plains or meadows, 
and you may not want these to be rendered as lakes. To minimize false lakes, put springs in the “real” lakes, 
as identified by having a coherent shape in the DEM Contour plot or from reference to the USGS 
topographic maps of the quadrangles. When you run rivers in Panorama, set the number of “Rivers from 
Lakes” to zero, and only those lakes which have springs in them or which have rivers running into them will 
be shown as lakes. Of course, remember that you have to “Fill Lakes” in Panorama for any lakes to be 
visible. Also, the river valleys in the DEM data will likely be interpreted as having numerous small lakes 
even when there are no lakes in the real landscape. For rivers to continue through these lakes in Panorama, 
the lakes must be full. 


Saving a Panorama Data File 


To begin the process of creating a Panorama data file, click the “Save Data” button. 


DEM Settings Files 


The first file requester to appear has “Use DEM Settings file?”’ in the titlebar. A DEM Settings file is 
an ordinary Amiga text file consisting of a series of commands for setting various parameters affecting the 
rendering of the landscape, such as Contour top heights, sea level, Contour blending amplitudes, colors, etc. 
The first word of the DEM Script file must be “ DEMScript” for the file to be recognized by GeoRama. 

The values of these parameters are stored in the Panorama data file created by GeoRama, so that 
when loaded into Panorama the landscape will be automatically configured as specified. The commands are 
similar to the Picture Script commands used in Panorama, with one very important difference. Elevations 
and elevation ranges are entered as absolute values in units of meters, rather than fractional values as in 

_ Panorama. Using the same DEM settings file for a series of Panorama patches cut out of the same group of 
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quadrangles ensures that the coloring of the landscape will be almost identical where the patches overlap, 
even though the range of elevations and the fractional height values used in Panorama may be different for 
the different patches. 

Either enter the name of the DEM Settings file in the file requester (including the extension) or, if you 
don’t want to use a DEM Settings file, click “Forget it.” In the absence of a DEM Settings file, generic 


values of the rendering parameters, colors, etc., will be placed in the Panorama Data file, and these can be = 
modified later within Panorama. 


Panorama Data File 


The second file requester is for entering the filename for the Panorama data file. The “.data” 
extension is added automatically. The saving process takes a while since the heights must be read and 
interpolated from the quadrangle files. Progress is indicated by the number of “rows left”” displayed in a 
small window that appears. The save will be finished when the “rows left” hits zero. You can abort the save 
operation at any time by clicking on the close gadget of this window, or by pressing the <ESC>key on the 
keyboard. 

The scaling factor giving the Panorama distance unit in meters, the coordinates of the center of the 
patch in DEM units as displayed on the GeoRama screen, and the absolute elevation in meters of the zero 
elevation level in Panorama coordinates are stored in the Panorama data file and can be retrieved after the 
data file is loaded by sending ARexx commands to Panorama. 


Statistics File 


A “statistics” file will be automatically created along with the Panorama data file. It is given the 
same base filename, but with an extension of “stat”. It is a standard Amiga text file, and gives some data on 
the selected quadrangles and on the region selected for Panorama. First, it lists all the quadrangles from 
which the Panorama region was selected by name, and gives the appropriate absolute coordinates at each of 
the four comers of each quadrangle. In the case of 7.5-minute data, the approximate angle between UTM 
North and true North is given in degrees, as it applies to the West edge of the central quadrangle. Since the 
Panorama rows are aligned with the DEM S-N profiles, you will need to use this as an offset to match 
viewing directions in Panorama between landscapes imported from 7.5-minute and one-degree data. = 

The “Overall Statistics” section gives the maximum, minimum, and average heights over all of the 
selected quadrangles, regardless of whether they are in the Panorama patch. The root mean square values of 
single and double height differences of neighboring points along profiles are also displayed. The “Relief aa 
Bias Index” is the ratio of an average height above the lowest point in the displayed quadrangles weighted 
by the square of the double height difference to the simple average height above the lowest point. If this is 
greater than 1.0 the landscape on average is rougher at higher elevations, and if less than 1.0 the landscape is 
rougher at lower elevations. 


The next group of data gives the exact location and size of the Panorama patch in DEM coordinates 
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scaled by the point spacings. 

Finally, there is some data specific to the particular Panorama patch selected, with units in Panorama 
units, not the DEM units. This includes, “DEM height unit in Panorama units,” the scale factor going from 
what is meters for USGS DEMs to Panorama units. Multiply by this number to convert an elevation 
difference in DEM units to an elevation difference in Panorama units. The root mean square single and 
double height differences come from averages over the Panorama patch for the Panorama points, as 
opposed to the DEM points. The height differences are taken along the rows in the Panorama grid parallel to 
the S-N direction in the DEMs. The separation L in Panorama units is just 2000 divided by 27 for Recursion 
Level 4 and by 81 for Recursion Level 5. The maximum and minimum elevations in the Panorama patch in 


Panorama units are relative to a zero point which is the average elevation over all the quadrangles as given 
in the “Overall Statistics.” 


General Information 


To make another Panorama data file from the same set of quadrangles, click “Pick Region ” and 
select a new region. To select a new set of quadrangles, click “New Quads.” To exit the program, click 
“Quit” or the window close gadget. 

Remember to fill lakes in Panorama, because even if you set some springs the rivers from them will 
not get very far before running into local depressions, and the rivers can continue only if the local 
depressions are full lakes. 

The data file created with GeoRama will have the Shading Type set to “‘Best” and “Smoothing On” 
set for all 5 Contours and the Cliffs. However, when you are experimenting with camera placement, sun 
directions and elevation angles, etc., you may not want to take the time for Best rendering. In Panorama, 
just set the Shading Type to Faceted until you are ready to render the final version. 

Be forewarned that DEM data from the USGS are not without flaws. The data was obtained by 
scanning topographical maps or aerial photos. The scanning process seems to have strongly smoothed the 
data on scales up to at least 200m, considerably greater than the 30m spacing of the data points in 
7.5-minute quadrangles. While the natural irregularites of the landscape on these scales have been removed, 
they have often been replaced by artifacts. Substantial areas of many 7.5-minute quadrangles have quite 
noticable regular, precisely East-West, ridges spaced about 200 meters apart. Occasionally there are even 
more prominent glitches where isolated points or groups of points are over (sometimes well over) a hundred 
meters too high or too low. When these are isolated points and have been noticed in test renderings, they 
have been repaired. The spacing of the points in the one-degree DEM data is about 93 meters S-N and about 
65-70 meters W-E at typical latitudes in the contiguous United States. 

The USGS data are public domain. You are welcome to use the data for any purposes you wish. 


However, the data as stored in the IFF format is copyright 1991 by James M. Bardeen. Copying of the data 
in this format is permitted for archival purposes only. 
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DEM Script Commands 


Within this section: 
r denotes a real number, n denotes an integer. 
“DEM units” are normally meters. 


Sealevel [rI] 
The absolute “sea level” height in DEM units, must be in range -20000.0 to 20000.0. 


RDScale [rl] 
The maximum depth of rivers, value in DEM units, must be within the range 0.0 to 100.0. 


FallsSlope [r1] 
The slope above which a river is colored as a waterfall, must be within the range 0.0 to 100.0. 


ContourTopsSolid [r12] [r23] [134] [145] a 

The absolute elevation in DEM units of the nominal boundaries between Contours 1 and 2 (r12), 
Contours 2 and 3 (r23), etc. The allowed range for ri2 is -20000.0 to 20000.0 and each successive entry 
must be greater than or equal to the previous entry and less than 20000.0. 


CliffSlopeAngles [r1] [12] r3] [4] [r5] 
The nominal maximum slope angles above which, for each Contour, the Cliff color is used. Values 
must be in range 0.0 to 90.0. 


SlopeBlend [rl] [12] [r3] [14] 
The ranges in DEM units over which the Contour boundaries can vary according to the local - 
steepness, for each of the four Contour boundaries. Values in range -20000.0 to 20000.0 accepted. 


NullSlope [rl] [r2] [r3] [r4] 
The slopes at which the Contour boundaries are equal to their nominal values when the SlopeBlend 


values are non-zero. Values in the range 0.0 to 10.0 accepted, though a value 0.0 means that the program will 
use a default value. 


ConCurveBlend [rl] [r2] [r3] [r4] 


Parameters governing the effect of local curvature on Contour boundaries. Values have the same 
meaning as in Panorama. Allowed ranges are -10.0 to 10.0. es 


CliffCurveBlend [r1] 


Parameter governing the effect of local curvature on classification of a triangle as a Cliff. Value has a 
the same meaning as in Panorama. Allowed range is -10.0 to 10.0. 
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ContourDither [n1] [n2] [n3] [n4] 


Integers that control the amount of blending together of Contour colors using dithering across nominal 
Contour boundaries. Values in range O to 64 are accepted. 


ConShadowDither [n1] [n2] [n3] [n4] [n5] 
Set the amount of shadow dither for each Contour. Values must be in the range 0 to 64. 


ContourTextures [n1] [n2] [n3] [n4] [n5] 
Select texture used for each Contour. Values must be in the range 0 to 64, 


ContourColor [cn] [rnge] ([r] [g] [b}) 

Set the color of Contour [cn], [cn] must be 1 to 5. The “range” [rnge] if 1 to 6 means use that preset 
color range in Panorama, while if 0 you must give the r, g, and b values for a custom color in the next three 
entries as integers from 0 to 255. 


CliffTexture [n1] 
Set the Cliff texture, in the range 0 to 64. 


ClifffidgeType [n1] 
Set the type of Cliff dithering, a number in the range 0 to 2. Enter 0 for sharp Cliff edges, 1 for 


moderately fuzzy Cliff edges, and 2 for diffuse mixing of the Cliff and Contour colors controlled by the 
CiiffDither setting below. The default value is 2. 


CliffDither [n1) [n2] [n3] [m4] [n5] 


Set the amount of Cliff dithering for each Contour in solid-mode rendering when the CliffEdgeType is 
2. There must be 5 entries, each a number in the range 0 to 64. 


CliffShadowDither [n1] 
Set the amount of shadow dither for the Cliffs. The value must be in the range 0 to 64. 


CliffColor [rnge] ([r] [g] [b}) 


Specify the preset color “range” for the Cliffs, or set to 0 and use a custom color defined by the r, g, b 
values as with ContourColors 


WaterTexture [nl] 
Set the number (0 to 64) of the water texture used in rivers and lakes. 


WaterColor [r] [g] [b] 
Set the “water” color for rivers and lakes as given by [r], [g], and [b] as integers from 0 to 255. 
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SeaTexture [n1] 
Set the number (0 to 64) of the sea texture. 


SeaColor [r] [g] [b] : 
Set the sea color used in 24-bit rendering. [r], [g], and [b] must integers from 0 to 255. 


WaterShadowOff a 


If this command is found, the rivers and lakes will be treated as “juminous.” Otherwise, water will 
respond normally to shadows. 


FallsColor [r] [g] [b] 
Set the waterfall color. [r], [g], and [b] must be integers from 0 to 255. 


FallsShadowOfft 


If this command is found, the waterfalls will be “juminous”. Otherwise, the waterfalls will respond 
normally to shadows. 


NoGroundPlane, LandGroundPlane, SeaGroundPlane 
Set the type of ground plane. 


CustomGroundPlane [tex] [r] [2] [b] 
Set a custom groundplane with the specified texture (0 to 64), and color RGB values (0 to 255). 


TreeTypes [0] [t1] [t2) [t3] [¢4] [t5] 
For the Cliffs and each Contour, set the Tree Type as one of three possibilities, “Oak”, “DFir”, or 
“ AFir.”” . 


TreeSizes [r0] [rl] [r2] [r3] [r4] [r5] 

Set the tree size for the Cliffs and all 5 Contours in DEM units. The “Tree Size” is roughly the height 
of the trees in DEM units, with ““DFir” trees a bit taller and “Oak” and “AFir” trees a bit shorter. The 
allowed range is 1.0 to 400.0, and the default is 50.0. 


TreeSpacings [s0] [st] [s2] [s3] [s4] [s5] Ee 
Set the average Tree Spacing for the Cliffs and each Contour. A value of 0.0 means no trees for that 
Contour, but the larger a positive value, the lower the tree density. There cannot be more than 3 trees per 


triangle, so while values are accepted in the range 0.0 to 1000.0, values less than a critical value depending 
on Recursion Level will imply the maximum possible density. 


24BitsOn 
Set the 24-bit flag in Panorama to “On”. = 
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End 
Terminates the script. 


All of the above commands are optional, in that default values will be set in GeoRama if the 
respective commands are missing from the DEM settings file. Any missing arguments or arguments out of 
range will cause execution of the script to be terminated. 


Custom DEM Settings files 


You can make your own DEM settings file using a text editor. Many of the DEM Settings commands 
are duplicates of or quite similar to Panorama Picture Script commands. 

Say you have created a Panorama data file from DEM data, loaded it into Panorama, tuned the 
Contour settings, colors, etc. to your liking, and now want to make a DEM Script file. First, save a Settings 
file. Some of the entries in the Settings file can be copied directly over to the DEM Script file, but 
Panorama units and relative height values must be converted into DEM units and absolute heights. 

To convert a Panorama relative height value to an absolute DEM height, multiply the relative height 
by the difference between the Panorama Max Z, and Min Z values, either as read off the Main screen or as 
obtained with the “MinMaxZ,” ARexx command, then multiply by the Panorama unit in DEM units as 
obtained with the “GetPanoramaUnit” ARexx command, and then add the value obtained with the 
“GetPanoramaZ Offset” ARexx command. 

To convert a Panorama relative height difference (e.g., a “SlopeBlend”’ value) to a height difference 
in DEM units, do as above, but omit adding the ZOffset value. 

To convert a “size” in Panorama (“RDScale” or “TreeSize”) to DEM units, just multiply with the 
value returned by “GetPanoramaUnit”’. 

Note that “DEM unit in Panorama units” stored in the Stat file created by GeoRama along with th 
Panorama Data file is just the inverse of the “PanoramaUnit” value. : 


Parameters such as ConCurveBlend and CliffCurveBlend are identical in Panorama and in the DEM 
Settings file. 
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SECTION XI: 
Hints and Tips 


Help with doing the usual and the unusual 


This section will help you create special effects using Panorama, including special types of 
landscapes and the ever popular fractal planet. The fact is, Panorama’s many, many capabilities don’t 
necessarily have to be devoted to the typical, mountainous terrain that has been discussed predominately so 
far. You can use the program to make almost anything you want. 


Variations on a theme 


There are many ways of varying Panorama’s fractal parameters in concert, in order to produce 
specialized terrain. We’ll discuss a few of them here, leaving you to experiment with further variations. 
These will be tutorials for creating a series of landscapes from the same random seed, whose value is 
463775901. Although the landscapes have the same general kind of stream network and mountains in more 
or less the same places, the feel and scale of the finished landscapes differs substantially as the landscapes 
build through the Recursion Levels. Other variations are more subtle. 


_ Variation 1 


Start Panorama from scratch, so that all of the program’s parameters have their default values. If you 
have customized a default ““PanoramaConfig.set” file, rename it to something else so the program won’t 
load it on startup. There’s no need to do this if you haven’t saved a customized version. Select ‘New 


Landscape.’ Enter the number 463775901 as the Seed for Random numbers. Click ‘OK’ to accept the default 
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Spring Probability and to accept the heights and springs at Level 1 without change. Select ‘Increase Level / 
To 4’ in the ‘Actions’ menu, or do ‘Increase Level’ one level at a time, three times, to increase the Recursion 
Level to 4, each time clicking ‘OK’ to accept the default Spring Probability. Next, ‘Fill Lakes.’ Wait until all 
lakes are full (This shouldn’t take long). ‘Run Rivers,’ and click ‘OK’ to accept the default numbers of 
springs and rivers from lakes. Now draw the picture (Select ‘Draw Picture’) to get an overall view of the 
landscape. If you wish, take a closer look at the landscape. A good position for the camera is at the south 
edge of the landscape, looking to the north, up the main river valley. Note the isolated, rather pointed, 
relatively low peak in the south-central part of the landscape between the two main branches of the river 
system. This arose because a point created at a low Recursion Level wound up being surrounded by 
substantially lower terrain. 


Variation 2 


Select ‘Jiggle Old’ in the ‘Fractal’ menu. This means all points, rather than just the new points, are 
given a random increment in height at each stage of the subdivision process. Start a new landscape, but keep 
the old seed by clicking ‘OLD’ in the requester for random seed. Increase the Recursion Level to 4 just as 
you did in Variation 1. ‘Fill lakes;’ “Run Rivers’ as before. Then draw the landscape. Notice that the high 
mountains are now only on the north side of the landscape, and the layout of the rivers is somewhat 
different. This is because the random number sequence is now being used to “jiggle” the old points as well 
as to determine the heights of new points. There are no sharply pointed hills like the one pointed out in 
Variation 1. Somewhat more smoothly rolling terrain is characteristic of “jiggled” landscapes, at least at 
lower elevations where the relief is not enhanced by the ‘Relief Bias.” However, Cliffs can still exist where 
they are created by the rivers. 


Variation 3 


Change the Vertical Offset parameter to 0.3, and reduce the Relief Bias parameter from 3.0 to 2.5, 
leaving the other fractal parameters unchanged. A large Relief Bias parameter together with a positive 
Vertical Offset and/or a low Fractal Index can oftem exaggerate the relief at high elevations. Restart the 
landscape from the same seed; increase the Recursion Level to 4, ‘Fill Lakes,’ and ‘Run Rivers.’ Draw a 
picture. The ‘Upward Bias’ makes the main rivers more sharply entrenched, with more noticeably V-shaped 
valleys, and gives the hills a more rounded appearance. The height of the terrain at the left (West) side of the 
landscape is considerably enhanced from Variation 2. 
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Variation 4 


Set the Fractal Index in the ‘Fractal’ menu to 1.4 and reduce the Relief Bias further to 2.0. The lower 
Fractal Index increases the fractal dimension of the landscape, which means that the amplitude of relief on 
small scales is larger relative to the amplitude of the relief on large scales. Start a new landscape using the 
old seed, and again increase the Recursion Level to 4. Fill lakes (note that the total number of lakes is 
considerably larger than before), run rivers, and draw the landscape. It seems to be almost all Cliffs; 
everything is jagged. The Max Z of the landscape is considerably larger than in earlier variations, even 
though the ‘Vertical Scale,’ which is the amplitude of the height fluctuations on the largest scale, is the same. 
The larger small-scale fluctuations are randomly superimposed on each other, and in places where they add 
up constructively they give a large total height. 


Variation 5 


Take the same landscape you constructed in Variation 4 and reduce the Vertical Scale from 2000 to 
600. This makes amplitude of fluctuations on small scales about the same as in Variations 1, 2, and 3, which 
with the smaller Fractal Index (larger fractal dimension), means that the relief is much subdued on large 
scales. Draw an overall view of the landscape. It is now apparent that the arrangement of the mountains is 
roughly the same as in Variation 3, but the impression, particularly if you compare views from near the south 
edge of the landscape looking up the main valley toward the mountains, is now of a much ‘larger’ landscape 
than in Variation 3. What appeared as individual mountains in Variation 3 now look like entire mountain 
ranges. The apparent distance to the mountains is many, rather than a few, kilometers. Aside from this 
difference of scale, Variation 5 looks much more like a Variation 3 than a Variation 4 kind of world. 
Landscapes in the real world seem to have larger fractal dimensions on scales of tens of kilometers than on 
scales of a few kilometers or less. 

The same kind of increase in apparent scale from Variation 3 to Variation 5 can also be accomplished 
by using Rescale Old Z at the first couple of Recursion Levels to reduce the amplitude of height fluctuations 
on large scales relative to the amplitude on small scales, without changing the Fractal Index. 


Variation 6 


Set the Relief Bias to 0, keeping all other parameters the same as in Variation 5. Recreate the 
landscape up to Level 4; fill lakes, and run rivers. Place the observer at the south edge of the landscape 
looking north, and draw a picture. Now the impression is of a uniformly hilly landscape, particularly if you 


_ change the color of Contour 3 from white to a shade of green (e.g., bring up the ‘Colors’ requester and make 


Contour 3 a somewhat darker green than Contour 2). The terrain on the North side of the landscape is still 
somewhat higher, but not different in character from the rest of the landscape. The relatively subdued relief 
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of this landscape is shown to best advantage with a fairly low sun elevation angle (Try 15 or 20 degrees). 


Variation 7 


Go back to the default fractal parameters of Variation 1: Fractal Index of 1.6, Relief Bias of 3. 0, 
“Jiggle Old’ off, and Vertical Scale of 2000.0, but set the Vertical Offset to -0.3. Regenerate the landscape. 
Note the many sharp spires in the mountains and the relatively broad river valleys. 


Variation 8 


Set the Fractal Index to 1.3, the Vertical Offset to +0.3, the Relief Bias to 2.0, and the Vertical Scale to 
700.0. Keep ‘Jiggle Old’ off. Restart the landscape. At Level 1 set the Fractal Index to 1.4. At Level 2 set the 
Fractal Index to 1.5. At Level 3, ‘Fill Lakes’ and ‘Run Rivers,’ making sure that all lakes have rivers. Set the 
Fractal Index to 1.6. Select ‘Rerun Rivers’ in the ‘Fractal’? menu (the item should be unchecked), and 
increase the Recursion Level to 4. This preserves the rivers from lakes while the new points are being added. 
permitting rivers from lakes to be entrenched into valleys. Fill the lakes again, and ‘Run Rivers.’ Draw the 
landscape. 

The impression here is similar to Variation 5, but the mountains are more interesting. If you’re willing 
to take the time, set the Fractal Index to 1.7 and increase the Recursion Level again. This landscape is not a = 
simple fractal, but at least qualitatively is probably more like real landscapes in having an effective fractal 
dimension which is a function of scale. 


> 


Experiment on your own 


These examples haven’t begun to explore the combinations of parameters, let alone the variations 
possible with over a billion random seeds. As you work with Panorama, develop your own list of “good” 
seeds for emphasizing various elements of the landscapes. Be sure to save settings when you come upon 
something “magical,” too. = 


Fractal Planets 


A spectacular picture of a planet with fractal continents and islands can be created fairly easily by 
importing a wrapping a suitable Panorama landscape around a sphere. ASDG’s Morph Plus is excellent for 
creating this effect, and some paint programs, including Oxxi’s SpectraColor, will handle the shading of the 
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planet to make it look like it is illuminated from one side by a sun. 
Create a landscape with a Fractal Index of perhaps 1.4 or 1.5.(larger values will give smoother 

— coastlines and fewer islands, smaller values the reverse). Fill lakes and run rivers. Adjust the sea level so you 
have a reasonable proportion of ocean and land for your planet. Reduce the vertical scale to a fairly small 
value (no more than a few hundred). You can try to find a landscape with high areas on opposite sides of the 
landscape to serve (with a Contour 5 color of white) as polar ice caps. Make the sun’elevation angle fairly 
high. A few very small shadows are O.K., but you don’t want any large shadows. Put the observer directly 
over the center of the landscape (the “U2” position), and adjust the field of view so that the size of the 
landscape is about the size you want for your planet. Import the landscape into Morph Plus or your paint 
program, and perform the transformation. 

The resulting picture could instead (or in addition) be mapped onto an object in your favorite 3D 
modeling and rendering program. 


Lava Rivers 


By suitable coloring and settings, you can make rivers of lava, glowing regardless of whether they are 
= in sun or shadow. If you want to have normal lakes and oceans with lava rivers, put ‘FallsShadowOff’ and 
“WaterShadowOn,’ and set only the waterfall color toa lava color using the ‘Colors’ requester. To force all 
of the rivers to be drawn in the waterfall color, set the ‘Waterfall Slope’ parameter to 0. 

A “Lava.set” Settings file is supplied with Panorama, incorporating these suggestions. You can see it 
work by creating a landscape (or loading a previous one’s “data” file, then loading the “Lava.set” file as 
“Settings.” Don’t change anything! Just draw the picture. Of course, you can then refine the “look” to suit 
your needs--even without rivers of lava, this “Settings” file makes very interesting, other-worldly terrain. 


Tip for setting heights 


When sculpting landscapes in the ‘New Landscape’ requester, keep in mind that points higher than 
about 1000.0 at Level 1 can lead to somewhat grotesquely exaggerated mountains at higher Recursion 
Levels, particularly if the ‘Relief Bias’ parameter is at its default value or larger. Don’t overdo the heights, 
unless these effects are what you desire. 


Adding and Deleting Springs 


Springs can easily be added to your landscape using the ‘AddSpring’ ARexx command. The map 
display in the Control Window shows the springs and lakes currently activated and the rivers they generate. 
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If you see a place on the map you would like to locate a spring, perhaps to extend a river further up a valley, 
you first need to find the i,j labels of the that location in the landscape. To do this, activate the map display 
in the Control Window by clicking it once with the left mousebutton. Now as you move the mouse pointer 
the labels for the point at the middle of the crosshairs are shown, just above the upper right corner of the 
Map Window. Make a note of the labels when the crosshairs are over the point where you want to add the 
spring. Press <Esc> to deactivate the Map Window, and then select the ‘ARexx Command? item in the 
‘Actions’ menu. An ARexx Command window will open, containing a long text gadget. Type in “AddSpring 
[i] [j]”. Don’t type the brackets or the quotes, and instead of i and j, type the i,j labels of the desired spring 
location separated by spaces. When you then press <RETURN>, the spring will be created, and the river it 
generates will be added to the map display. It will be visible if you go ahead and draw a picture. - 
To get rid of a spring, you must first find the i,j labels of the spring. Follow the procedure using the 
Map Window outlined above to find the labels of the point right at the beginning of the river you want to 
eliminate, or try various spring numbers in the ‘GetSpringPos [n]’ ARexx command until you get what --- 
seems to be the right location. Then type “KillSpring” into the ARexx Command window text gadget 
followed by the i,j values separated by spaces. If the labels you entered were not the location of a spring, you 
will get an “Error in Command Execution” message and a return code of 10. Try again with adjacent values 
of i and j (remembering that they must be either both even or both odd). 


Setting River and Spring Depth 


Rivers from permanent springs can be given non-zero widths right from the beginning, if you use the ad 
“SpringDepth’ ARexx command. The command takes as arguments the number of the spring affected and an 
‘Initial Depth’ index, an integer. An ‘Initial Depth’ index of 0, the default value, means that the river starts 
out as just a line, widening gradually it goes downstream. A value of 127 or greater means that the river 
Starts out with its maximum possible depth (and width). There are actually only 40 depth levels in the 
present version of Panorama, but the range 0-127 allows for future enhancements. A negative value for the 
“Initial Depth’ index turns off the spring completely, so no river flows from it. The ‘Initial Depth’ for each 
spring is stored when you create a Panorama “Data” file. The ‘Initial Depth’ index is a measure of the 
initial depth as a fraction of the maximum depth; the maximum depth of the rivers as a group can still be 
scaled. using the River Depth parameter. 

The ability to set an initial river depth is particularly useful when importing real landscapes into ma 
Panorama from USGS DEM files, since well-established rivers may flow into the region cut out for import 
into Panorama. Another appropriate situation is a landscape with lava rivers, since lava flows normally have 
their full size right away. Placing a spring with a non-zero ‘Initial Depth’ in a lake will widen the river as it — 
leaves the lake on the downslope. ® 
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Troubleshooting your results 


Panorama is a large program, with many options and possibilities. If you find yourself in a corner, 
here are some suggestions on identifying what to do to get the results you want. 


1. The picture contains large areas of solid green or gray. 


Diagnosis: You are trying to show too many Contours on a high-res screen. 

Bike Solution: Either reduce the number of Contours that are checked in the ‘Show Contour’ submenu of 
the ‘Switches’ menu to only 1 or 2 or turn on 24-bit and convert toa HAM (4096-color) screen when the 
drawing is finished. You could also save the 24-bit picture and convert it to an Amiga-displayable format 

_._ with an image processing program such as ASDG’s Art Department Professional. 


2. The sky looks flat 


Diagnosis: Your chosen display mode doesn’t have enough colors to render the sky correctly. 
Solution: Plot in 24-bit mode and convert to HAM. Within smaller color palettes, there aren’t enough 
colors left over to render the skies. The information is there, but not displayed on the screen. Conversion to 
— HAM is done from the 24-bit data, not from the picture as displayed, so it can be substantially different (and 
better!) from what you can see on the Amiga screen. 


= 3. ARexx scripts (like the F10 demo one) won’t work 


Diagnosis: ARexx is not running, or not installed on your machine. 
Solution: Check to see whether you have ARexx installed correctly. A simple way to do this is to bring 
up a Shell Window and type the following command: 
rexxmast 
If you get a message that ARexx is already running, it is. If not, and you get a message that ARexx is 
= now running, your problem is solved. If AmigaDOS reports that it cannot find the rexxmast program, you 
should check your ARexx installation. Note the previous comments in the ARexx section here about various 
versions of AmigaDOS and ARexx’s automatic (or not) installation. 


4. The trees don’t show or look monotonal. 


Diagnosis: Either not enough palette colors, or too large a vertical view angle, or tree colors (in 24-bit) 
the same as surrounding terrain. 


Solution: If you have positioned the camera looking too steeply downward, trees will not show. Move 
the camera back and perhaps use a longer focal length lens, from a higher point of view. 

Panorama makes great-looking trees, but you need the larger HAM palette in Amiga-displayable 
resolutions to see them--or enhanced display hardware such as DCTV or a 24-bit frame buffer card. To see 
trees on standard Amiga hardware, do your picture in an Amiga-displayable resolution with the 24-bit switch 
rr en 
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turned on. When the picture is complete, use the picture screen’s pulldown menu to convert to a HAM 
display. 
For the other possible diagnosis, edit the custom colors (for 24-bit files), or select a different tree-leaf 


and bark color from the pulidown menu, making sure to choose one that’s not being used to draw the 
surrounding Contour. 


Memory management 


Panorama can be memory hungry. The program requires several bytes of memory with which to 
record for each point the height, information about lakes and rivers, and, while drawing the landscape, — 
information about where shadows are located. Every attempt has been made to manage memory efficiently, 
but there is no way to work on large amounts of data without consuming large amounts of memory. Memory 
allocation for storage of the landscape data is done only as it is needed. Moreover, the program releases 
memory when it is no longer required, in order to remain as friendly as possible to multitasking. 

If no other large program is running, Panorama should run comfortably through Recursion Level 4 on 
an Amiga with 2 megabytes of memory, and through Level 5 on an Amiga with 3 or more megabytes of 
memory. If you use the 24-bit option, these requirements will increase by up to 1 megabyte or even more, 
depending on the screen resolution and overscan mode selected. 

If Panorama is unable to allocate the memory it needs for certain major operations, like increasing the 
Recursion Level or opening a picture screen, it will automatically restore the program to its previous state 
and pop up a requester telling you, “Not enough memory to do it!.”’ Operation of the program can usually 
continue normally. 

It’s possible for Panorama to find just barely enough memory for its internal purposes, though it or 
some other program you have running doesn’t leave enough memory for the Amiga’s operating system to 
manage pulldown menus and requesters. Danger signs of this problem are a requester window’s failing to 
open or the failure of a menu to pull down when you use the right mousebutton (if the window which 
controls the menu is active). In such an event, you should take prompt action to free some memory, to avoid 
a system crash. Since in this situation the menus won’t work, you can use keyboard commands to control 
Panorama. \f this happens, take steps as follows: 

If a picture screen is currently active, press <ESC> to get rid of it. If a picture screen has been held in 
the background, you can get rid of it by drawing a preview picture (Right Amiga - V). This also gets rid of 
any 24-bit picture in memory. 

Hf possible, set a new sun direction using the ‘Sun Position’ submenu in the ‘View’ menu. This will 
free memory used to store shadows and brightness levels. 

If you have filled the lakes in the current Recursion Level, erase them by pressing Right Amiga - F. If 
this action brings up the ‘Fill Lakes’ requester, click ‘EMPTY.’ If there was not enough memory to open the 
requester window, the memory allocated for keeping track of the lakes will be automatically deallocated. 

Reduce the Recursion Level. To do this from the keyboard, press Right Amiga - X. 

If all else fails, quit Panorama by pressing Right Amiga - Q, or by clicking on the close gadget of the 
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Control Window. 
If you’re unable to open a picture screen, you may still be able to draw the landscape using a drawing 
tes mode which requires less memory. The low-res non-interlace “Draw Mode 1” uses the least memory. The 
default “Draw Mode 2,” with an interlace screen, needs twice as much memory. Of course, you should 
avoid use of overscan if memory is tight. 


Workbench On and Off 


Since Panorama itself runs independently of the Workbench Screen, some memory can be saved by 

closing Workbench. The ‘WBench On’ menuitem will be checked if the Workbench screen is open when 

— Panorama starts up. If you find yourself short of memory, you can attempt to close the Workbench screen by 
selecting ‘WBench On’ (It’s a toggle). However, the Workbench screen cannot be closed as long as any 
program windows are open on it. If the closure attempt is successful, the checkmark in front of “WBench 

a On’ will disappear. Selecting ‘WBench On’ again reopens the screen, if memory is available to do so. If you 
have memory to do so, you should normally keep the Workbench screen open--Panorama’s default. To run 
ARexx macros, you will need a window open on the Workbench screen, which must be open, of course. 


Starting Over 


Panorama comes with a configuration settings file named “PanoramaConfig.set.”’ This file can be 
re-loaded as ‘Settings’ anytime you like, in order to return everything to “default” settings. You can also 
ae re-save your own choices for these defaults using this filename, so that the program will henceforth come up 
with its defaults, including its default 24-bit palette, set the way you want. To be loaded automatically, the 
“PanoramaConfig.set” file must be in the directory from which Panorama is run (not necessarily the same 


as the directory in which Panorama resides if you run Panorama from the CLI or SHELL) or in the system 
S: directory. 


Limitations 


If you generate a picture of some real place and then take a printout to the place for a look around, you 
won’t necessarily find all the trees in the same places, but the curvature of the land, and its “look” at a given 
time of day will be right--corresponding to the season and time that puts the sun at the same angle as you’ve 

soe rendered. Of course, the program permits putting the sun in a position it can’t ever get to in the real 
world--like North, for places in the northern hemisphere. 
Don’t expect Panorama to generate Saguaro cacti, Joshua trees, or other distinctive vegetation that 
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distinguishes a locale. Moreover, if you tell the program to put lots of oak trees in the middle of a desert 
landscape you’ve loaded, it will happily do as you command. 

Panorama also doesn’t put in roads, picnic shelters, nor litter barrels--nor litter, bane of landscape 
photographers in the real (not to say, cruel) world. 

Panorama’s trees are two-dimensional, fractally generated Kinpess not three-dimensional objects. 
They look great, even fairly close, but if you try to look down at them from above, they won’t be visible. 
Three-dimensional trees are slated for a future release of the program. Meanwhile, the flat ones work for 
almost all purposes, and being “‘fractally correct,” they fit in with Panorama’s personality. 

Although Panorama applies shadows of mountains and other terrain to water surfaces, and although 
the program renders sky reflections, Sheen, and the like, it does not attempt to render reflections in water 
surfaces of the surrounding landscapes, nor dies it render shadows of its trees. If you need reflections, you 
can still put them in after saving the Panorama picture. Use your favorite paint program to edit the picture to 
your liking. For best results in performing this tricky task, however, use HAM or higher palettes, so you’ll ae es 
have enough colors to render a good reflection. 

There is a limit to how close you can get to the landscape. Panorama will not draw a landscape 
triangle which crosses the plane through the camera position perpendicular to the view direction. If the 
camera is only a fraction of a triangle edge length above the surface of the landscape, such a triangle may 
extend into the field of view of the camera, and produce a ‘hole’ in the picture. If this happens, just raise the 


camera a bit or increase the focal length of the camera, so that the offending triangle will not extend into the 
picture. 
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- APPENDIX A: 
_ Basic training 


If you don’t know how to Operate your Amiga computer, refer to the manuals that come with it, in 
order to gain some familiarity with Operating the mouse, pulld. 
here will help you once you get over that initial hurdle. 

This manual has been written for use by relatively inexperienced Amiga users, 


‘Own menus, etc. The information provided 


se Operating pulldown menus 


The menus associated with the Panorama Control Window provide many options for operating 
— Panorama. Be sure the Control window is active. If it is inactive, the title bar of the window will look fuzzy, 
that is, “ghosted.” Activate it by clicking anywhere in the window with the left Mousebutton. To use a 
pulldown menu, move the Mousepointer to the top of the screen an 
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Multiple selections 


While you’re “shopping” among the pulldown menus and submenus, you can make multiple 
selections at one time by continuing to hold down the right mousebutton while you click with the left ae 
mousebutton over the desired selections. Any checkmarks will appear (or disappear) when you make 
selections, and all of your menu choices will be in effect when you let go of the right mousebutton. For 
instance, you can select both ‘Increase Level’ and ‘Fill Lakes’ from the ‘Actions’ menu, so lakes will be 
filled automatically once calculation of the new Recursion Level is complete. Be sure to release the right 
mousebutton while the pointer is still over the menu, or some of your selections might not take effect. 

If you access the pulldown menus and then decide you want to make xo menu selection, move the 


mousepointer to the titlebar before letting go of the right mousebutton. No menu choices will be in effect 
(unless you’ve used the left button click to make some). 


Menu ghosts 


If a menuitem or subitem seems fuzzy, this means that the item is currently inactive, or “ghosted,” 
and cannot be selected. The program makes an item inactive when the function it controls is not appropriate 


in the current situation--such as a function which modifies an existing landscape when no landscape is 
_ present. 


Keyboard shortcuts 


Some commonly used Panorama menuitems can be selected directly from the keyboard, using the 
Right-Amiga key together with some other key--without accessing the pulldown menus. These include most 
of the items in the ‘Actions’ menu, and the ‘Draw Mode’ subitems in the ‘Switches’ menu, as well as others. 


All of the key combinations are indicated to the right of the item text within the menus. These are listed in 
Appendix D, 


Informational requesters 


The simplest “requesters” are those which are purely informational or which just ask for a Yes/No _ 
response. When Panorama is busy with a long calculation and is unable to respond to menu selections, etc., 
a box giving a progress report will usually appear. In other cases, the box will contain a statement or 
question and buttons labelled ‘OK’ and ‘CANCEL.’ Click the appropriate button (in some cases it makes no = 
difference which one) when you are ready to proceed. Generally, you must satisfy requesters that ask for 
input before the program will do anything else, no matter how long you wait. The progress windows will 
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abort the ongoing processgenerallyif you click their “Close” button (always located in the top left corner of 
their windows). : 


Parameter entry 


In the interactive mode, as opposed to Picture Scripts and ARexx macros, parameter values are passed 
to Panorama using requesters and gadgets. A parameter requester is a window through which numbers are 
passed to Panorama and which appears when data entry is needed or when you have selected an appropriate 
menuitem. Typically the requester window can be moved around on the screen using the drag bar along the 
top of the window, but cannot be resized or shifted front to back. No other operations with Panorama are 
possible until the requester window is closed, whether satisfied or cancelled. 

The window will contain one or more text gadgets for typing in numbers. The text gadgets will be 
primed with the default or previous values of their respective variables or parameters. 
£53 In some cases a slider, or proportional gadget, will be located just to the side of or just below the text 
gadget. You can move the control knob of the slider to the left or right by dragging it with the mouse. Press 
down the left mousebutton when the pointer is over the control knob. Keep the button down as you move the 
mouse, and the control knob will follow along. The number displayed in the text gadget will change, to a 
larger value if the knob moves right or to a smaller value if the knob moves left. Release the mousebutton 
when the desired value shows in the text gadget. Clicking on the slider to the right or left of the knob will 
move the knob right or left by one notch. The range of values accessible using the slider is not necessarily 
the whole range of admissible values for the parameter. When the previous value of the parameter is outside 
the normal range of the slider, the slider’s upper limit or lower limit, as appropriate, is usually extended to 
this previous value. ; 

oo You can also enter values directly into a text gadget from the keyboard when the text gadget is active 
(has the cursor showing). Backspace first, to clear the existing number. The slider, if any, associated with the 
text gadget will be updated when you press <RETURN?> to enter the new number. 

_ A text gadget can be activated by clicking on it with the mouse. In some requesters with more than 
two text gadgets another option is available. The currently “selected,” but not activated, text gadget, is the 
one that’s shaded to look “pushed in.” To activate the selected gadget, press <RETURN>. Then type in the 
new number and press <RETURN>. To select another gadget, move the box around using the arrow keys. 
This avoids having to alternate between the mouse and the keyboard. The arrow keys will not function when 
the selected gadget is activated. 

When the text gadgets show the desired values of the parameters, click ‘OK’ to accept them and exit 
the requester. When there is only a single text gadget, pressing <RETURN> when the gadget is active also 
exits the requester. Usually, Panorama checks the values to see if they are within the acceptable range. If 
not, the screen will flash and the requester will remain open. Clicking ‘CANCEL’ closes the requester and 
— restores the value(s) in effect when the requester opened. 
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Installation 


As one of the first things you do, make a copy of the Panorama disks. Store the original ones in a safe 
place, and do all your work with the copy. Panorama is self contained except for its reliance on the shared 
libraru file req.library for the operation of its file requesters. This is part of the Ami gaDos 2.0 (and higher) ~ 
Operating system, but must be added to earlier systems. The file “req.library” is included on the Panorama 
release disks, along with a program to install it where it belongs on your system. The install program works 
best if you customarily boot your Amiga from the same Workbench disk all the time, or if you normally boot 
from a harddisk drive. If you find that Panorama runs from its floppy disk, but not from your other disks, or 
from your harddisk drive, you should put the reg. library file in the “‘libs:” directory for your other disks, or 
in the “SYS:libs” directory of your primary harddisk partition. To have this operation performed for you 
automatically, boot your Amiga on your intended disk (harddrive or floppy) and then use the “install” utility 
on the Panorama program disk by doubleclicking its icon. The AmigaDOS script associated with the install 


icon will automatically put req.library where Panorama expects to find it. The installation process is not 
necessary if you’re using AmigaDOS 2.0 or higher. > 


Note also that although Panorama works under AmigaDos 1.2, the install utility does not. If you’re 
still using AmigaDos 1.2, you must put the Panorama program disk in your internal drive (“df0:”) and issue 
the following simple commands in a CLI window: 


copy panorama3.0:libs/req.library libs: 


Remember, Panorama is shipped on a disk that will not boot your Amiga. Your boot disk, whether a 
floppy or a harddisk, must have sufficient free space for the library--about 18,000 bytes. 


File Requester 


Panorama brings up a file requester whenever you save or load a file, whether it is a data file, a script 
file, or an IFF picture. The same or similar file requesters are used in a number of other programs, in 
particular Art Department Professional. 

When the file requester first comes up it will try to load the current directory, which is initially the 
directory from which Panorama was run. If it is unable to find the directory--perhaps you have removed the 
disk containing it--a requester will appear asking you to reinsert that disk. There is no need to do so. Just 
click ‘CANCEL’ in the requester. Then click on the name of the “Device” you want to access from the list at 
the righthand side of the requester. A list of the directories and files in the root directory of that Device will 
appear in the main part of the requester window. To access a directory, click on the directory’s name. If there 
are more filenames and directories than will fit in the requester display at one time, use the scroll bar to ae 
move through the list. Files are displayed in alphabetical order. 


The title bar of the file requester window displays a description of the type of file and whether it is 
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being saved or loaded. In some cases the file type is indicated by a filename extension such as ‘.data’ or 
*.serpt.’ When an extension is required, the extension will be given in parentheses in the titlebar. When 
saving a file, this extension will automatically be added to any filename you supply, if it is not already 
present. When loading a file, you should only select filenames with this extension. The file requester itself 
will do the screening for you if you leave the wildcard in the ‘Show’ box unchanged. The directory 
(“Drawer”) and filename are entered in separate text gadgets. If you click a filename in the directory listing, 
it will automatically be entered into the filename gadget for you, so you can modify it if desired. Be careful 
of using a name that already exists when saving a file. The pre-existing file will be overwritten, and its 
contents will be lost--replaced by the new file by the same name. 

Once the desired directory and filenames are displayed in the text gadgets, accept them by clicking 
“OK? at the bottom of the requester. To abort the file retrieval or save operation, click ‘Forget It.’ 
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APPENDIX B: 
Harddisk installation 


Panorama will run fine from floppies, but you’ll find it much more convenient to run it from your 
computer’s harddisk drive. To get it there in the first place, simply create a drawer (Its name doesn’t matter.) 
to put Panorama in. Doubleclick the Panorama program disk icon on the Workbench screen to open its 
window. While holding down the <SHIFT> key (either one of them), click all of the icons in the Panorama 
disk’s window, to light them up. When you click the last one, still holding the <SHIFT> key down, then 
“drag” the icons with the mouse, and let go of the mousebutton and the key when the mousepointer is 
directly over the icon for the drawer you’ve made for Panorama to live in. 

This operation moves all of Panorama’s files to the drawer, including those contained in 
subdirectories, their icons, etc. Pop the Panorama disk out of the floppydisk drive before running Panorama 
from your harddisk. No system assigns or other commands are necessary, but you do have to install the 
“req.library” file to your system disk. If your system boots from its harddisk drive, you can just doubleclick 
the icon for Panoramalnstall on the Panorama disk, and let the program install it for you. If Panorama 
refuses to run when you crank it up, you probably need to run Panoramalnstall. 
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Appendix C: 
~ What you can change 
- without recalculation 


Panorama pre-calculates shadow, brightness, and Contour/Cliff values before it creates a picture. If 
you change only the superficial elements such as the view, you need not go through the recalculation process 
to generate another picture. Here are some of the things that are safe to change: 

Camera position 

Camera view direction (as long as the sun is not in ‘Auto’ mode) 

SS Lens focal length 

24-bit toggle 

Overscan modes and aspect ratios 

oa Contrast parameters 

River Depth and Waterfall Slope 

Contour and Cliff textures, Contour and Cliff dithering, shadow dithering 

All tree, water, Wave, groundplane, haze, horizon, and cloud settings 

Max Distance, Pic Resolution parameters 

All colors 
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APPENDIX D: 
Keyboard Shortcuts 


Control Window Function Keys 


Show/Hide Held picture screen FS 
Execute ARexx macro (optional) F6,F7,F8,F9,F10 
Main Screen to front ‘Help’ 


Control Window menu Selections 
‘Actions’ menu 


New Landscape Amiga-N 
Fill Lakes Amiga-F 
Run Rivers Amiga-R 
Draw Preview Amiga-V 
Draw Picture Amiga-D 
Save Data Amiga-A 
Load Data Amiga-Z 
Save Settings Amiga-S 
Load Settings Amiga-L 
Make Pic Script Amiga-P 
Exec Pic Script Amiga-E 
ARexx Command Amiga-K 
Reduce Level Amiga-‘-’ 
Quit ; Amiga-Q 
‘Actions’ menu / Recursion Level 
Up 1 Amiga-1 
To3 Amiga-3 
To4 Amiga-4 
To 5 Amiga-5 


St epee, 


146 


©1993 Push-Button Publishing 


‘Actions’ menu / Save Picture 


Amiga ILBM Amiga-I’ 
IFF 24 Amiga-U 
‘Switches’ menu / Draw Modes 
Solid Low-res Amiga-J 
Solid Low-res Lace Amiga-M 
Solid Hi-res Lace Amiga-H 
Simple Wireframe Amiga-X 
Wireframe Hidden Lines Amiga-/ 
‘Switches’ menu / Overscan Modes 
None Amiga-0 
704x440(704x552) Amiga-9 
704x480(704x566) Amiga-8 
736x482(736x566) Amiga-7 
768x482(768x566) Amiga-6 
= Workbench Amiga-W 
‘Switches’ menu / Shading Type 
Faceted Amiga-C 
Gouraud Amiga-G 
Better Amiga-T 
Best Amiga-B 
‘Picture’ Screen Shortcuts 
Custom Colors Requester F3 
Hide mousepointer F5 
Adjust centering of picture 
. Screen on Amiga display: Arrow Keys 
‘Project? menu 
Convert To HAM Amiga-H 
Save Amiga Picture Amiga-I 
Save 24-bit Picture -  Amiga-U 
Exit Amiga-Q or <ESC> 
‘Preview’ Screen 
Return to Main screen <ESC> or mouseclick 
Draw Full Picture <D> or <RETURN> 


Automatic Arexx macro execution: 

The ARexx macros files must be named with one of the following names to be accessible from the 
corresponding Function Key. They must be located either in the directory fro which Panorama was run or in 
the system REXX: directory, 

F6.Panorama F7.Panorama 
F8.Panorama F9.Panorama 
F10.Panorama 
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Appendix E: 
Data file structures 


This information on the format of landscape data files is intended for programmers who want to write 


a program separate from Panorama which will generate a height field or convert a height field from some 
external data base, and then store the height field in a file in a form allowing it to be imported into 
Panorama for rendering. Possible examples include height fields of actual landscapes, either taken from 
Contour maps or converted from USGS databases, mathematical functions of two variables, 3D 
representations of the Mandelbrot set, or any other type of information which can be displayed as a height 
field. This program might also be useful for generating pictures of real data extracted by the new electronic 
mapping and Geologic Information Systems techniques. 


Since checking for lakes is best left to Panorama, only the format for data files without lakes is 


described here. 


With the present version of Panorama the points on which the height field is evaluated must be in an 


array whose size and shape corresponds exactly to the size and shape of a Panorama landscape at one of the 
allowed Recursion Levels. That is, the points must be arranged in the same number of rows, with exactly the 
same number of points per row. Detailed information on how the horizontal arrangement of points varies 
with Recursion Level is presented in a later section. The labels i and j of a point are related to its horizontal 
position by 


x = 0.5*hscale*i 
y = 0.866*hscale*j 


where hscale is the length of a triangle edge at the current Recursion Level. In Panorama the value of 


hscale at Recursion Level r is 6000.0 divided by r factors of 3. 


The number of rows and the number of points in each row can be expressed in terms of a quantity Q 


which is a function of the Recursion Level; Q = 1 at Level 1, 3 at Level 2, 9 at Level 3, 27 at Level 4, and 81 
at Level 5. The row labels j range from -(5*Q-1)/2 to (5*Q-1)/2, for a total of 5*Q rows. The points in the 
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jth row have i labels ranging from -maxifj] to maxi[j] in steps of 2, where 

1) for j >=2*Q, maxi[j] = 9*Q - 3*j - 1; 

2) for 2*Q >=j >=(Q-1)/2, maxi[j] = 5*Q -j-1; 

3) for (Q-1)/2 >=j >=0, when j and (9*Q-1)/2 are both even or both odd, maxi[j] = (9*Q.- 1)/?2, 
otherwise maxi[j] = (9*Q-3)/2; : 

4) for j <0, maxi[j] is the same as maxi[-j]. There are (maxi[j] + 1) points in the jth row. 

All numbers are stored in the same format in which they are stored internally in the Ami Za, Since the 


file sizes would balloon considerably if the numbers were Stored in ASCII fo: 


rm. The variable types used are 
listed below: 


STRING: an array of characters, Used for the headers at the beginning of the file, the first of which 
must be “Panorama001” for a heights only data file. Pad out the Space with null characters. 

INTEGER: a 16 bit signed integer. , 

CARDINAL: a 16 bit unsigned integer. 

LONGINT: a 32 bit Signed integer. 


BOOLEAN: one byte signifying TRUE or FALSE. FALSE is 00000000 in binary, and TRUE is 
11111111 (e., ~1), 


FFP: a 32 bit real number in Motorola Fast Floating Point format (see the ROM Kernal Reference 
Manual: Libraries and Devices). 


LOCATION: a Sequence of two INTEGERs labeling a point in the landscape, 
and then the row label j. A total of 4 bytes. 


An array of one of these variable types is denoted by ARRAY following the type name. The number 


first the column label i 


the Recursion Level, the Contour level, or the spring number, and which applies is indicated by [r] for the 
Recursion Level, by [c] for the Contour level, and by [s] for the spring number, 

The file format is described by giving a Variable Description, a Variable Type, and then the number of 
bytes for each variable or array. When appropriate, the number of bytes is given in terms of the numbers Q 
or maxi[j] defined above. 

Entries preceded by asterisks are stored, but not read, by the current version of Panorama, Accurate 


values may be important for compatibility with a future version of Panorama. “Reserved” indicates space 
left in the file for future expansion, which should be filled with zeros. 


Header (‘ ‘Panorama001'* ) STRING 32 


Name of data file (Optional) STRING 80 
Random Seed LONGINT 4 
Recursion Level CARDINAL 2 
Fractal Index {r] FFP ARRAY 24 
Vertical Offset Parameter [r] FFP ARRAY 24 
Low/(High Only) Relief Toggle [r] BOOLEAN ARRAY 6 
Relief Bias Parameter [r]J FFP ARRAY 24 
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Meander Slope Parameter FFP ARRAY 24 
divided by Vertical Scale [r] 


Height Fluctuation Amplitude FFP 4 oo 
Panorama Unit in ‘‘’meters’’ FFP 4 
Center x-coordinate FFP 4 
Center y-coordinate FFP 4 ue 
Panorama z offset FFP 4 
Seed for Roughen operation LONGINT 4 
Jiggle On/Off [r] BOOLEAN ARRAY 6 7 
File Pos 250 
Spring Probabilities [r] FFP ARRAY 24 
Number of springs at CARDINAL ARRAY 14 

each Recursion Level [r] ~ 
Vertical Scale FFP 4 
Fractional Sea Level FFP 4 
River Depth Scale FFP 4 _ 
Waterfall Slope Parameter FFP 4 
Solid fractional Contour FFP ARRAY ; 60 

top heights [c] = 
Cliff Slope Angles [c] FFP ARRAY 64 
Slope Blend Values [c] FFP ARRAY 60 
Wireframe fractional Contour FFP ARRAY 20 

top heights [c] _ 
Permanent Springs On/Off [r] BOOLEAN ARRAY 6 
Rerun Rivers On/Off [r] - BOOLEAN ARRAY 6 
Eile Pos 520 ; , To 
Water shadows On/Off BOOLEAN 1 
Waterfall shadows On/Off BOOLEAN 1 
Water dither On/Off BOOLEAN 1 = 
Sea dither On/Off BOOLEAN 1 
Sky Horizon Texture/Color ARRAY OF BYTES 4 
Haze Texture/Color ARRAY OF BYTES 4 
Thin Cloud Texture/Color ARRAY OF BYTES 4 ~ 
Thick Cloud Texture/Color ARRAY OF BYTES 4 
RESERVED (0 ae at a ane 12 
Eile Pos 552 = 
Sky Zenith Texture/Color ARRAY OF BYTES 4 
Water (River/Lake) Texture/Color ARRAY OF BYTES 4 
Waterfall Texture/Color ARRAY OF BYTES 4 ~ 
Sea Texture/Color ARRAY OF BYTES 4 
Custom Groundplane Texture/Color ARRAY OF BYTES 4 - 
Custom Contour Color On/Off [c] BOOLEAN ARRAY 16 
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Solid Contour Color Presets [c] 
Shading Type 

Groundplane Type 

24 bits On/Off 

RESERVED 

File Pos 608 

Horizon Height 

Haze Height 

Haze Density 

Solid Contour Texture/Color [c] 
Cliff Custom Colors On/Off [c] 
Cliff Color Presets [c] 
Contrast in sun 

Shadow/Sun contrast 

Island Mode On/Off [r] 
RESERVED 

File Pos 732 

Cliff Texture/Colors [c] 

Wire Contour Texture/Colors [c] 
Wire Sky Texture/Color 

Wire Water Texture/Color 
Contour Shadow Blend [c] 

Cliff Shadow Blend [c] 


Contour Smooth Shading On/Off [c] 


Cliff Smooth Shading On/Off [c] 
Contour Dithering [c] 
ConCurveBlend parameters [c] 
CliffCurveBlend parameters 

for each Contour [c] 


Null Slope Values [c] 


Cliff-Contour Dithering [c] 
Cliff Boundary Type 
Non-local curvature On/Off 
Haze Type 

Sky-Horizon Type 

Clouds On/Off 

Trees On/Off 

Wave Type 

RESERVED 

File Pos 1116 


Random Seed for Clouds 


ARRAY OF BYTES 
BYTE 

BYTE 

BOOLEAN 


FFP 

FFP 

FFP 

ARRAYS OF BYTES 
BOOLEAN ARRAY 
ARRAY OF BYTES 
FFP 

FFP 

BOOLEAN ARRAY 


ARRAYS OF BYTES 
ARRAYS OF BYTES 
ARRAY OF BYTES 
ARRAY OF BYTES 
ARRAY OF BYTES 
ARRAY OF BYTES 
BOOLEAN ARRAY 
ARRAY OF BYTES 
ARRAY OF BYTES 
FFP ARRAY 

FFP ARRAY 


FFP ARRAY 
ARRAY OF BYTES 
BYTE 

BOOLEAN 

BYTE 

BYTE 

BOOLEAN 
BOOLEAN 

BYTE 


LONGINT 


16 


RPE PPR 
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64 
16 
16 
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64 
24 


16 
16 
16 
16 
16 
60 
64 
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Cloud 
Cloud 
Cloud 
Cloud 
Cloud 
Cloud 
Cloud 


Size 
x-y ratio 
Contrast 
Threshold 
Fuzziness 
Height 
x-position 
Cloud y-position 
Cloud Angle 
RESERVED 
File Pos 1164 
Random Seed for Waves 
Sky Reflection On/Off 
Lake Waves On/Off 
Number of Waves 
RESERVED 
Sheen Amplitude 
Wave Amplitude 
Wave Size 
Main Wave Contrast 
Wave Shape 
Wave Phase 
Main Wave Center x 
Main Wave Center y 
RESERVED 
File Pos 1220 
Random Seed for Trees 
Contour Tree Sizes [c] 
Cliff Tree Sizes [c] 
Contour Tree Spacings [c] 
Cliff Tree Spacings [c] 
Contour Tree Types [c] 
Cliff Tree Types [c] 
Contour Leaf Texture/Colors [c] 
Cliff Leaf Texture/Colors [c] 
Contour Bark Texture/Colors [c] 
Cliff Bark Texture/Colors [c] 
RESERVED 
File Pos 2044 
Show springs and rivers 
up to this Recursion Level 


FFP 
FFP 
FFP 
FFP 
FFP 
FFP 
FFP 
FFP 
FFP 
FFP 


LONGINT 
BOOLEAN 
BOOLEAN 
BYTE 


LONGINT 
ARRAY OF 
ARRAY OF 
ARRAY OF 
ARRAY OF 
ARRAY OF BYTE 

ARRAY OF BYTE 

ARRAYS OF BYTES 
ARRAYS OF BYTES 
ARRAYS OF BYTES 
ARRAYS OF BYTES 


FFP 
FFP 
FFP 
FFP 


or b&b & b&b bb bh SB 


PP bb ee PREP E RP RP 
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32 
32 
32 
32 


32 
32 
32 


32 
548 
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Number of rivers from lakes CARDINAL 2 


Locations of Springs LOCATION ARRAY 4*(# springs) 
—_ Initial River Depths ARRAY OF BYTES (# springs) 
RESERVED -----+-- 3*(# springs) 
*Minimum row label j INTEGER 2 
*Maximum row label j INTEGER 2 
7 *Minimum and maximum INTEGERS 20*Q 
column labels i for each row, in order of decreasing 4 
Height of each point in FFP 4* (18*Q*Q+1) 


landscape, stored by rows from maximum to minimum j, each row has 
maxi[j]+1 points, total number of points = 18*Q*Q+1 


poe The total number of bytes in the file must be 
4*(18*O*O + 5*9 + 514 + 2*(# springs)). 


oa The values of many of the parameters are not critical, in that they can be reset in Panorama after the 
height data are loaded. Non-zero values should be legal; Panorama will usually modify zero values of 
rendering parameters when these are illegal. However, you should be careful to set the Recursion Level and 

cal the Fractal Indexes properly. The Height Fluctuation Amplitude should also be set appropriately, since this is 
used to scale “roughening” and in any increase of Recursion Level. For a simple fractal landscape it should 
be the Vertical Scale divided by the Fractal Index to the power of twice the Recursion Level. 


Provision is made for storing values of the fractal parameters for each Recursion Level, with 6 
Recursion Levels. 


The colors of various components of the landscape are stored in 24-bit format as 4 Bytes, the first is 
interpreted as a texture value (0 to 64) and the remaining three bytes as RGB values (0 to 255). At present, 
= the texture byte is ignored for sky, waterfall, haze, cloud, and wireframe colors. 
Provision is made for 16 Solid-mode Contours, of which the first 5 are now used, and 6 
Wireframe-mode Contours. Cliff colors are stored as if they could have different colors for different 
ee Contours, though for the present version all these colors are the same. 


eee 
Panorama version 3.0: Picture Perfect Fractal Landscapes 153 


Appendix F: 
Picture Script and 
ARexx Commands 


Commands that can be part of a Picture Script are listed here. Most can also be a commands in an 
ARexx macro, and are so indicated by “(ARexx)’’ following the statement of the command’s syntax. The 
ARexx-only commands are in Appendix G. The ranges of allowed values are the same for parameters 
entered with commands from ARexx macros and Picture Scripts. However, return codes are generated only 
by commands issued from ARexx macros. If an error occurs in the execution of a Picture Script command, 
the script aborts, and a requester appears with an error message, which may include the portion of a 
command Panorama was unable to interpret. The ARexx macro should handle any non-zero return codes 
appropriately. The ARexx commands can also be sent to Panorama one at a time using the requester called 
up by selecting the ‘ARexx Command’ item in the ‘Actions’ menu, even if you do not have ARexx installed 
on your system. 

In this listing, each command is enclosed in quotes, along with its arguments. The quotes should not 
be included in the Picture Script itself. The keywords are not case sensitive. Parameter values should be 
separated by spaces, without any punctuation. 


Observer-View Commands 


‘ViewTargetOn,’ ‘View TargetOff’ (ARexx) 
Switch between the two modes for entering view direction information. The mode affects how 
tweening of the view direction is done in a Picture Script. With ViewTargetOn, the view target coordinates, 
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as set by TargetX, Target Y, TargetZ, are tweened, while with ViewTargetOff, the absolute view 
direction and the vertical view angle are tweened. The View mode changes automatically to the appropriate 
= mode when a view direction command specific to that mode is processed. 


‘ObsDir [n.nn]’ (ARexx) 
_ Set the compass angle to the observer (camera). 
[n-nn] -- a real number in the range -720.0 to 720.0. 
If an error or not in range then return code 10, and the previous value is preserved. 


‘ObsDist [n.nn]’ (ARexx) 
Set the distance from the center of the landscape to the observer. 
[n.nn] -- a real number in the range 0.0 to 200000.0. 
If an error or not in range then return code 10 and the previous value is preserved. 


‘ObsX [n.nn],’ ‘ObsY [n.nn]’ (ARexx) 
— Set the horizontal Cartesian coordinates of the observer’s position. Tweened. 
[n.nn] -- a real number in the range -200000.0 to 200000.0. 
If an error or not in range then return code 10 and the previous value is preserved. 


‘ObsZ [n.nn]’ (ARexx) 
Set the absolute height of the observer. Tweened when the absolute height mode is in effect, as it is 
after this command is executed. 


[n.nn] -- a real number in the range -100000.0 to 100000.0. 


‘RelObsZ [n.nn)’ 
—~ Set the height of the observer as a relative height--the height above the surface of the landscape. 
When the observer is not above the landscape, the observer height is set relative to the height of the 
landscape at the point closest to the observer along the line from the observer position to the center of the 
landscape. Tweened when the relative height mode is in effect, as it is after execution of this command. 
[n.nn] -- a real number in the range 5.0 to 100000.0. 


If an error or not in range the previous value is preserved, and the return code is 10. 


‘ViewDir [n.nn]’ (ARexx) 

Set the absolute view direction of the observer as a compass angle, increasing clockwise looking 
down on the landscape. The angle is 0 when the observer is looking North. If the ViewDir and ObsDir 
angles differ by 180 degrees, the observer’s line of sight goes through the center of the landscape. Tweened 
when ViewTargetOff is in effect, which it is just after this command is issued. 

[n.nn] -- a real number in the range -720.0 to 720.0. 


ad If an error or not in range then return code 10 and the previous value is preserved. 
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“Vert ViewAngle [n.nn]’ (ARexx) 
Set the vertical angle below the horizontal of the observer’s view direction. Tweened when 
ViewTargetOff is in effect, as it is after execution of this command. 
[n.nn] -- a real number in the range -90.0 to 90.0. 
If an error or not in range then return code 10 and the previous value is preserved. 


‘BankAngle {n.nn]’ (ARexx) i 
Set the bank angle of the camera. Positive values rotate the camera clockwise about the OPSEIVEr Ss 
line of sight. Tweened. 
[n.nn] -- a real number in the range -720.0 to 720.0. a 
If an error or not in range then return code 10 and the previous value is preserved. 


*TargetX [n.nn],’ “Target Y [n.nn],’ *TargetZ, [n.nn]’ (ARexx) 
Set the Cartesian coordinates of the view target point. Tweened if “ViewTargetOn’ is in effect, as it 
is after any of these commands is executed. 
[n.nn] -- a real number in the range -200000.0 to 200000.0. 
If an error or not in range then return code 10 and the previous value is preserved. 


‘FocalLength Auto/[n.nn]’ (ARexx) 


Set the field of view of the camera. “Auto” puts the camera lens in Auto mode, so that the field of 
view is adjusted according to the distance of the observer from the landscape. A number [n.nn] sets a 
particular value of the lens focal length, which is tweened in Picture Script animations. 
[n.nn] -- the value of the camera focal length, which must be between 10.0 and 5000.0. = 
If second entry is not ’Auto’ or a number then return code 20. 
If the number is not in range, then return code 10 and the previous value is preserved. 


General Rendering Commands 


‘DrawMode [n]’ (ARexx) 
Set the draw mode among the 5 possibilities that are presented in the ‘Switches’ menu. 
[n] -- an integer between 1 and 5 inclusive. The order is the same as in the pulldown menu, with 1 = 
being low-res non-interlace solid mode and 5 being wireframe with hidden lines removed. 
If an error or not in the range, then return code 10. 


‘AmigaOverscan [n]’ (ARexx) 
Set the overscan mode for pictures on the regular Amiga display. 


[n] -- an integer between 0 and 5 inclusive. The number corresponds to the order of selections in 
the top half of the ‘Overscan’ submenu in the Switches menu, with 0 being no overscan and 5 being 
overscan identical to that of the Workbench screen. 
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If an error or not in range then return code 10. 


‘24bitOverscan [n1] {[n2]}? (ARexx) 
Set the overscan mode for 24-bit pictures created in memory. 

(n1] can an integer between 0 and 3 inclusive, in which case 0 means that the size in pixels of the 
24-bit picture will be the same as the picture drawn on the regular Amiga display, while values 1 to 3 give 
standard VGA and SuperVGA screen dimensions of 640x480, 800x600, and 1024x768, respectively. 
Otherwise, [n1] and [n2] are interpreted as the picture width and height in pixels, and must be in the range 
160 to 8000 for [n1] and 100 to 8000 for [n2]. Only the portion of the picture (upper left corner) that fits into 
7 the Amiga display screen as sized by the AmigaOverscan and DrawMode settings will be visible as the 
picture is being drawn. 

If an error or not in range then return code 10. 


‘SunPosition [sundir] [sunangle]’ (ARexx) 
Set the sun direction from 6 possibilities (0 for South to 5 for ESE, clockwise) and the sun elevation 
angle. The elevation angle is tweened. 
[sundir] -- an integer from 0 to 5 inclusive. 
[sunangle] -- a real number in the range -89.9 to 269.9. 
If an error in either argument, return code 10 and the previous value is preserved. 


‘VerticalScale [n.nn]’ (ARexx) 
Set the vertical scale of the landscape. Tweened. 
= [n.nn] -- a real number in the range 1.0 to 20000.0. The default value is 2000.0. 
If an error or not in range then return code 10 and the previous value is preserved. 


‘SeaLevel [n.nn]’ (ARexx) 
Set the sea level as a fraction of the range between zmin and zmax, the lowest and highest 
elevations in the landscape. A value of 0.0 means all land, and a value of 1.0 means all sea. 7 weened. 
{n.nn] -- a real number, must be in the range -10.0 to 10.0. 
If an error then return code 10 and the previous value is preserved. 


‘RDScale [n.nn]’ (ARexx) 
Set the river depth scale. Note how the default values in the River Depth requester (‘River’ 
submenu in ‘Features’ menu) decrease with increasing Recursion Level. 
[n.nn] -- a real number in the range 0.0 to 1000.0. 
— If an error or not in range then return code 10 and the previous value is preserved. 


‘FallsSiope [n.nn]’ (ARexx) 
Set the slope at which a river is colored as a waterfall. 
[n.nn] -- a real number in the range 0.0 to 100.0. The default value is 0.3. 
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If an error or not in range then return code 10 and the previous value is preserved. 


‘MaxDistance [n.nn]’ (ARexx) 
Set the maximum distance from the observer for which the landscape will be drawn. Can be used to 
Speed up rendering when the more distant parts of a landscape are hidden, or for special effects. A value of 
0.0 means that all of the landscape will be drawn regardless of distance. 
[n.nn] -- a real number in the range 0.0 to 20000.0. ~ 
If an error or not in range then return code 10, and the previous value is preserved. 


‘PicResolution [n.nn]’ (ARexx) 


Set the picture resolution parameter. Default value is 1.2. The higher this value, the smaller the 
projected size of the landscape triangles on the screen can be before landscape is drawn with coarsened 
resolution. Smaller values speed up rendering at the cost of less detail in the pictures. Rivers are not drawn 
at the coarsened resolution. Values much larger than 1.0 mean that the more distant triangles will project to 
less than one pixel in width, and therefore won’t be drawn properly. 

[n.nn] -- a real number in the range 0.0 to 1000.0. 
If an error or not in range then return code 10 and the previous value is preserved. = 


‘AmigaAspectRatio [n.nn]’ (ARexx) 

Alter the assumed value of the aspect ratio of pixels on the monitor screen that Panorama uses in = 
translating picture coordinates into pixel labels. You don’t need to fiddle with this if you’re using a standard 
Amiga monitor. The aspect ratio is the ratio of pixel width to pixel height on hi-res, interlace, or low-res, 
non-interlace screens. It is automatically adjusted for low-res, interlace screens. The default NTSC value is 
0.846, cozily between the value of 10/11 assumed in DeluxePaint and the value of 11/13 assumed in Art 


Department Professional. For AmigaDOS2,0, this is the value specified in ROM for hi-res interlace screens. 
[n.nn] -- a real number in the range 0.2 to 5.0. 


If an error or not in range then return code 10 and the previous value is preserved. .. 


Solid Mode General Rendering Commands 


‘24BitsOn,’ ‘24BitsOff’ (ARexx) 

Set or clear a switch which enables 24-bit rendering when a picture is drawn in one of the Solid 
draw modes. The 24-bit information is stored in memory as the picture is being drawn to a conventional 
16-color or 32-color Amiga screen. In a Picture Script the picture can be saved either as a 24-bit IFF file or, 
if ‘StartHAM’is in effect, as a HAM mode approximation to the 24-bit picture. 


‘24bitAspectRatio [n.nn]’ (ARexx) a 
Set the aspect ratio for 24-bit pictures sized separately from the Amiga display overscan, i.e., drawn 
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with one of the four choices in the bottom half of the ‘Overscan’ submenu in the ‘Switches’ menu 
checked. The default value is 1.0, as is roughly appropriate for most VGA or SuperVGA displays. The 
— picture that is drawn on the Amiga monitor screen may be significantly distorted when this option is in 
effect, particularly if you are in the ‘Solid Lo Lace’ draw mode. ° 
[n.nn] -- a real number in the range 0.2 to 5.0. 


= If an error or not in range then return code 10 and the previous value is preserved. 


‘ShowContour Yes/Cliff/Merge Yes/Cliff/Merge ... (5 entries)’ (ARexx) 

Select which Contours are to be rendered with distinct colors in normal Amiga pictures. For each of 
the five Contours, enter ‘Yes’ to give the Contour its own color, enter ‘Cliff’ to give the Contour the Cliff 
color, or enter ‘Merge’ to give the Contour the color of the next highest Contour (or the the Cliff color for 
the top Contour). For low-res (32 color) pictures as many as four Contours can have distinct colors before 
there is much degradation of picture quality, but with high-res there will be some degradation with more 
than one ‘Yes’ entry, and more than 3 ‘Yes’ entries means no brightness variations in the sun at all. What you 
do here has no effect on 24-bit pictures. You can set all five entries to ‘Yes’ to preview the Contour layout 
— for a 24-bit picture. 

Any error gives a return code of 10 and the previous arrangement is preserved. 


oe. ‘ShadingType [n]’ (ARexx) 
Choose the type of shading used, either faceted or one of three smooth shading options, for the 
Contours with Smoothing On. 
[n] -- an integer in the range 0 to 3 inclusive. The numbers correspond to the order of the subitems 
in the ‘Shading Type’ submenu of the ‘Switches’ menu. 


If an error or not in range, then return code 10. 


oe ‘SmoothShading On/Off On/Off On/Off On/Off On/Off On/Off? (ARexx) 

Select between smooth shading (‘On’) and faceted shading (‘Off’) for the. Cliffs (first entry) and 
each of the five Contours (remaining entries). All six entries must be present regardless of the number of 
Contours being displayed as determined by the ‘NumberContours’ command. While the ‘ShadingType’ is 0 
(faceted), these commands have no effect. 

If an error in reading an entry, the old value of that entry is preserved, and the return code is 10. 


‘SunContrast [n.nn]’ (ARexx) 
Adjusts the range of brightness values for the sunny portions of the landscape. Tweened. 
[n.nn] -- a real number in the range from 0.0 (for no brightness variation) to 1.0 (for the maximum 
brightness variation). 
If an error or not in range then return code 10 and the previous value is preserved. 


ae ‘ShadowContrast [n.nn]’ (ARexx) 
Adjusts the contrast between the shadow color and the key color for all the landscape elements. 
Tweened. 
scene ere 
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[n.nnj -- a real number in the range from 0.0 (for no difference between the shadow brightness and 
the lowest sun brightness) to 1.0 (for completely black shadows). 


If an error or not in range then return code 10 and the previous value is preserved. 


‘WaterShadowOn,’ ‘WaterShadowOff’ (ARexx) 
Toggle between showing shadows on the water (rivers and lakes only) or making the water 
“Juminous” and unaffected by shadows or sun angle. This overrides the dithering setting and makes the 
water a pure color equal to the key color. 


‘FallsShadowOn,’ ‘FallsShadowOff’ (ARexx) 
Toggle between showing shadows on the waterfalls or making waterfalls “luminous.” 


‘WaterDitherOn,’ ‘WaterDitherOff’ (ARexx) 
Toggle dithering for water (i.e., rivers and lakes). The dithering makes the brightness and texture of the 
water vary with sun angle. The water in sun is a pure color equal to the water key color when dithering is off. 


‘SeaDitherOn,’ ‘SeaDitherOff’ (ARexx) 
Toggle dithering for the sea, both as part of the landscape proper and as the ground plane. The 
dithering makes the brightness and texture of the sea vary with sun angle. The sea in sun is a pure color 
equal to the sea key color when dithering is off. 


‘WaterTexture [n]’ (ARexx) 
Set a value for the water texture. The allowed range of 0 to 64 is the same as for Contour textures. 
In Amiga rendering the only effect is to choose between two families of dither patterns, a ‘smooth” pattern 
for the range 0 <= [n] <= 32, and a somewhat coarser pattern for the range 33 <= [n] <= 64. In 24-bit 


rendering the number within the range controls the amplitude of brightness fluctuations in the texture 
pattern. 


{n] -- an integer in the range 0 to 64. 
If an error or out of range then return code 10. 


‘SeaTexture [n]’ (ARexx) 
Set a value for the sea texture, which functions the same as the water texture above. 
[n] -- an integer in the range 0 to 64. 
If an error or out of range then return code 10. 


‘BlurringOn,’ ‘BlurringOff’ (ARexx) 
Toggle a switch which when on means that subsequent 24-bit IFF files or HAM pictures will have a 
blurring algorithm applied to to the 24-bit data. This has the effect of reducing sharp transitions between 
colors, and smoothing out the “jaggies” on diagonal color boundaries. Blurring may be desirable if the 


picture is eventually to be displayed in video, where sharp transitions between some colors can lead to jitter 
or crawl. 
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Solid Mode Colors 


‘ContourColor [Contour] [range] {[r] [g] [b]}? (ARexx) ; 
Set the color for a particular Contour. If [range] is 0, the remaining three values give the red, green, 

and blue palette values for a custom color. If [range] is from | to 6, a default color range is used, with the 
value corresponding to position in the ‘Colors’ submenus, and any further entries are ignored. 

[Contour] -- an integer in the range 0 to 5, where 0 means Cliffs and 1-5 are solid mode Contour 
values. 

[range] -- an integer in the range 0 to 6 (see above). 

[r],[g],[b] -- palette values. Each must be an integer in the range 0 to 255. 

Any value outside the allowed range gives a return code of 10. 


‘CliffColor [range] {[r] [g] [b]}’ (ARexx) 

Set the color for the Cliffs. If [range] is 0, the remaining three values give the red, green, and blue 
palette values for a custom color. If [range] is from 1 to 6, a default color range is used, with the value 
corresponding to position in the ‘Colors’ submenus, and any further entries are ignored. 

[range] -- an integer in the range 0 to 6 (see above). 
[r],[g],[b] -- palette values. Each is an integer in the range 0 to 255. 

Any value outside the allowed range gives a return code 10. 


‘LeafContourColor [Contour] [r] [g] [b]’ (ARexx) 


Set the “leaf” color of trees associated with a particular Contour. Contours with the same TreeType 
can have different tree textures and colors. 


[Contour] -- an integer in the range 1 to 5. 
[r].[g],[b] -- palette values in the range 0 to 255. 
An error gives a return code of 10. 


‘BarkContourColor [Contour] [r] [g]} [b]’ (ARexx) 


Set the “bark” color for the trees of a particular Contour, in the same way as for the leaf color as 
described above. 


[Contour] -- an integer in the range 1 to 5. 
[r],[g].[b] -- palette values in the range 0 to 255. 
An error gives a return code of 10. 


‘LeafCliffColor [r] [g] [b]’ (ARexx) 
Set the color of the leaves of trees on Cliffs. 
[r].[g].[b] -- palette values in the range 0 to 255. 
An error gives a return code of 10. 
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‘BarkCliffColor [r] [g] [b]’ (ARexx) 
Set the “bark” color for the trees on the Cliffs, in the same way as for the leaf color as described 
above. 


{r][g],[b] -- palette values in the range 0 to 255. 
An error gives a return code of 10. 


‘HazeColor [r] [g] [b]? (ARexx) 
Set the color approached as the haze optical depth becomes large. 
[r].[g],[b] -- palette values in the range 0 to 255. _ 
An error is indicated by a return code of 10. 


‘WaterColor [r] [g] [b]’ (ARexx) = 
Set a custom color for the water (rivers and lakes). 
{r].[g].[b] -- palette values in the range 0 to 255. 
Any value outside the allowed range gives return code 10. 


‘FallsColor [r] [g] [b]’ (ARexx) 
Set the waterfall color (in sun). 
[r],[g],[b] -- palette values in the range 0 to 255. “< 
Any value outside the allowed range gives return code 10. 


‘SeaColor [r] [g] [b]’ (ARexx) =e 
Set a custom color for the sea, either as part of the landscape or as a ground plane. 
[r].[g],[b] -- palette values in the range 0 to 255. 
Any value outside the allowed range gives a return code of 10. 


‘NoGroundPlane’,‘SeaGroundPlane’ ,‘LandGroundPlane’ (ARexx) 

A ground plane can be used to define a true horizon when the mountain ridgeline as seen from the 
viewpoint of the camera does not do so. With ‘NoGroundPlane’ the sky/horizon coloring will extend down 
below the horizon, but if haze is on in 24-bit rendering the haze will still define the horizon, since where 
there is no landscape below the horizon the pathlength through the haze is infinite. With ‘SeaGroundPlane’ 
the ground plane is colored with the Sea color (24-bit and HAM) or the Water color (standard Amiga = 
rendering). Note that Waves will be drawn on the ground plane in this mode, but Sheen will not. With 
“LandGroundPlane’ the color of the lowest Contour selected to be visible in Amiga rendering is used for the 
ground plane in both 24-bit and Amiga rendering. 


‘CustomGroundPlane [n] [r] [p] [b]’ (ARexx) 
Set a custom color texture and color for the ground plane. The first argument is the texture, an 


integer in the range 0 to 64 which is interpreted in the same way as the other texture settings. The remaining 
three arguments are the RGB palette values, integers in the range 0 to 255. The custom color is only visible 
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in 24-bit and HAM rendering; in standard Amiga rendering the color used is the lowest active Contour 
color, as with the ‘LandGroundPlane’ option. An err 


or or out-of-range value gives a return code of 10. 


‘SkyColor [r] [g] [b]’ (ARexx) 
Set a custom color for the sky (at zenith in 24-bit renderin 
fs background color. 
[r].[g].[b] -- palette values in the range 0 to 255, 
Any value outside the allowed range gives a return code of 10. 


g). In Amiga rendering this is the 


‘HorizonColor [r] [g] [b]’ (ARexx) 


Set the color of the Sky at the horizon (in the absence of haze). Only visible in 24-bit rendering. 
[r],[g],[b] -- palette values in the range 0 to 255. 
Any value outside the allowed range gives a return code of 10. 


*‘ThinCloudColor [r] [g] [b]’ (ARexx) 
Set the color at the edge of the clouds. This affects only 24-bit and HAM rendering. In normal 
Amiga rendering, the clouds have the same color as the waterfall color. 
[r],[g],[b] -- palette values in the range 0 to 255. 
3 Any value outside the allowed range gives a return code 10. 


‘ThickCloudColor [r] [g] [b]’ (ARexx) 
Set the color of “thick” clouds. This affects only 24-bit and HAM rendering. In normal Amiga 
— "rendering, the clouds have the same color as the waterfall color, 
{[r],[g],[b} -- palette values in the range 0 to 255, 
Any value outside the allowed range gives a return code 10. 


Contour Parameters 


Zz ‘ContourTopsSolid [h12] [h23] [h34] [h45]’ (ARexx) 
Set the nominal heights of the solid mode Contour boundaries as fractions of the range between 
zmin and zmax. The nominal values may be modified by other commands which make the Contour 
boundaries sensitive to local slope and curvature, and Contour dithering may mix the Contours together, so a 


negative value may not exclude lower Contours from the picture and a value greater than 1.0 may not 
exclude higher Contours. 


[h12] -- areal number in the range -2.0 to 4.0, 
[h23] -- a real number in the range h12 to 4.0. 
[h34] -- a real number in the range h23 to 4.0. 
[h45] -- a real number in the range h34 to 4.0. 
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An error in reading an entry leaves the old value unchanged with return code 10. 


‘SlopeBlend [b12] [b23] [b34] [b45]’ (ARexx) 
Set the range of relative heights over which each nominal Contour boundary can be adjusted in 

response to the local slope of the terrain. Only works in the solid rendering modes. For flat terrain the 
boundary is lowered by 1/2 of the appropriate SlopeBlend value, while the boundary is raised by 1/2 the 
value for very steep terrain. The defaults are 0.0, 0.2, -0.2, 0.2, and values between -0.5 and 0.5 are . 
recommended. 

[b12],[b23],[b34],[b45] -- real numbers in the range -10.0 to 10.0. 

An error in reading an entry leaves the old value unchanged with return code 10. a 


‘NullSlope [s12] [s23] [s34] [s45]’ (ARexx) 


Set the slopes at which the corresponding Contour boundaries are at their nominal values under the — 
action of the Slope Blending described above. 


{s12],[s23],[s34],[s45] -- real numbers in the range 0.0 to 10.0. 
An error in reading an entry leaves the old value unchanged with return code ‘10. 


‘LocalCurvature,’ ‘NonLocalCurvature’ (ARexx) 

Toggle between two ways of calculating the curvature of the landscape for use in implementing the 
‘ConCurveBlend’ and ‘CliffCurveBlend’ commands. The curvature is calculated from the hei ghts of the ~ 
nearest neighbors of each point when ‘LocalCurvature’ is in effect. Heights of more distant points are used 
to calculate a kind of fractally averaged curvature with ‘NonLocalCurvature.’ ‘NonLocalCurvature’ is the 
default, and gives much more natural looking effects at higher Recursion Levels, but increases the time to ~~ 
calculate the brightness values by a modest amount. 


‘ConCurveBlend [c12] [23] [c34] [c45]’ (ARexx) 
Set parameters determining how each Contour boundary depends on the local curvature of the 


landscape surface. A postive value lowers the Contour boundary in gullies and raises them on ridges, and a 
negative value does the reverse. Only works when Contour interpolation is in effect. 


[c12],{c23],{c34],[c45] -- real numbers in the range -10.0 to 10.0. _ 
An error in reading an entry leaves the old value unchanged with return code 10. 


‘ContourDither [n12] [23] [n34] [m45)’ (ARexx) = 
Set the amount of pixel-by-pixel dithering of Contours together at each Contour boundary. Only 
affects the solid rendering modes when Contour interpolation is in effect. 
[n12],[n23],[n34],[n45] -- integers in the range 0 to 64. 
An error in reading an entry leaves the old value unchanged with return code 10. 


‘ContourTextures [t1] [2] [t3] [4] [t5]’ (ARexx) 
Set values for the Contour texture for all five Contours at once. 
[t1],[t2],[t3],[t4],[t5] -- integers in the range 0 to 64. 
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An error in reading an entry leaves the old value unchanged with return code 10. 


‘ConShadowDither [s1] [s2] [s3] [s4] [s5]’ (ARexx) 
Set the amount of shadow blending for all five Contours at once. 
[s1],[s2],[s3],[s4],[s5] -- integers in the range 0 to 64. 
An error in reading an entry leaves the old value unchanged with return code 10. 


Cliff Parameters 


“CliffSlopeAngles [al] [a2] [a3] [a4] [a5]’ (ARexx) 
For each Contour, set the nominal slope angle above which a landscape triangle will be treated as 


part of a ‘Cliff.’ The actual Cliff boundary is modified by the CliffCurveBlend parameter and the Cliff 
Dithering values when Contour interpolation is in effect. 


{a1],[a2],[a3),[a4],[a5] -- real numbers in the range 0.0 to 90.0. 
An error in reading an entry leaves the old value unchanged with return code 10. 


‘CliffCurveBlend [n.nn]’ (ARexx) 


-Set a parameter determining how much the presence of a Cliff depends on local curvature of the 
landscape surface. A positive value makes Cliffs less likely in gullies and more likely on ridges. Only works 
in the solid rendering modes when Contour interpolation is in effect. 

[n.nn] -- a real number in the range -10.0 to 10.0. 
If an error or out of range the old value is preserved and return code 10. 


‘CliffEdgeType [n]’ (ARexx) 

Set the type of dithering between Cliffs and Contours. A value of 0 for [n] means “sharp” 
boundaries regardless of the Cliff Dither values; 1 means “fuzzy” boundaries but still with relatively bare 
Cliffs away from the Cliff edges; and 2 means “diffuse” dithering with specks of Contour color well inside 
the Cliffs when ‘Cliff Dither’ values are fairly large. 


[n] -- an integer in the range 0 to 2. 
If out of range, the old value is preserved and return code 10. 


‘CliffDither [dl] [d2] [a3] [a4] [a5] (ARexx) 
Set the amount of Cliff dithering for each Contour. 
[d1],[d2},[d3],[d4],[d5] -- integers in the range 0 to 64. 
An error in reading an entry leaves the old value unchanged with return code 10. 


‘Clifffexture [n]’ (ARexx) 


Set a value for the Cliff texture, which is interpreted in the same way as a Contour texture value. 
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{n]-- an integer in the range 0 to 64. 
An error in reading an entry leaves the old value unchanged with return code 10. 


‘CliffShadowDither [n]’ (ARexx) 
Sets the amount of shadow blending for the Cliffs. 
[n] an integer in the range 0 to 64. 
An error in reading an entry leaves the old value unchanged with return code 10. 


Tree Parameters 


“TreesOn,’ “TreesOff’ (ARexx) 
Toggle trees on or off. However, ‘TreesOn’ only takes effect when 24-bit rendering is enabled, since 
there are not enough colors available on standard Amiga screens to handle trees. The trees will be drawn on 
the 32-color or 16-color screen--so you can monitor the tree placement and abort if things are not turning out 


as you intend--but not in their true colors. After the drawing is completed, selecting ‘ConvertToHAM’ 
generates a HAM approximation to the 24-bit picture. 


*TreeSeed’ (ARexx) 
Adjust the random seed used to set the pattern of tree placement and the variations in the tree shape 
from one tree to the next. By default, the Fractal Seed is used. 


“TreeTypes [type] [typel] [type2] [type3] [type4] [type5]’ (ARexx) . 

Choose which type of tree to use for the Cliffs ({type0]) and each of the five landscape Contours 
([type1]-[type5}). Currently there are three types of trees, labeled “Oak,” “DFir” (for Douglas Fir), and 
“AFir” (for Alpine Fir). The entry for each Contour must be one of these three labels. ae 6 entries must be 
present, even if you wish to change only one. 


[typeO], . . ., [type5] -- tree type labels. 
An error in reading an entry leaves the old value unchanged with return code 10. 


‘TreeSpacings [r0] [r1] [r2] [r3] [14] [r5]’ (ARexx) 

Set the average distance between trees for the Cliffs and each Contour, except that an entry of 0.0 
means than there are no trees for that Contour. A spacing of about 1/2 the Tree Size or less will give a dense 
forest, and larger spacings a more open forest. However, there are at most three trees in each landscape 
triangle, which particularly at lower Recursion Levels may mean the actual average spacing is considerably 
larger than value specified. 

{r0],{r1],{r2],[r3],[r4],[15] -- real numbers in the range 0.0 to 2000.0. 
An error in reading an entry leaves the old value unchanged with return code 10. 
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‘TreeSizes [s0] [s1] [s2] [s3] [s4] [s5]’ (ARexx) 

Set the absolute size of the trees for the Cliffs and each Contour. The number is roughly the height 
of the tree in Panorama units. It is a good a idea to keep the Tree Size smaller than about twice the Tree 
Spacing, since otherwise trees will overlap substantially. 

[sO},[s1],[s2],[s3],[s4],[s5] -- real numbers in the range 1.0 to 1000.0. 
An error in reading an entry leaves the old value unchanged with return code 10. 


“TreePixelDensities [p0] [p1] [p2] [p3] [p4] [p5]’ (ARexx) 
= Scale how many screen pixels will be devoted to representing each fractal tree--separately for the 
Cliffs and the five Contours. The default values are 1.0. Beyond a certain density the pixels are just drawn 
on top of each other without any improvement to the picture. A lower pixel density will speed up the 
rendering, perhaps at the cost of detail. The default settings should be satisfactory most of the time. 
{p0},{p1].[p2],[p3],[p4],[p5] -- real numbers in the range 0.1 to 10.0. 
An error in reading an entry leaves the old value unchanged with return code 10. 


a ‘LeafTextures [t0) [¢1] [¢2] [3] [¢4] [t5]’ (ARexx) 


Set the texture values for tree leaves on Cliffs ({t0]) and on each of the five Contours ([t1] - [t5]). 
The brightness of the leaves of a given tree fluctuates from pixel to pixel with an amplitude related to the 
= texture value. 


[tO] ... [t5] -- integers in the range 0 to 32. 
An error in reading an entry leaves the old value unchangedwith return code 10. 


‘BarkTextures [tO] [¢1] [¢2] [3] [¢4] [¢5]’ (ARexx) 


Set the texture values for “bark” of trees on Cliffs ({t0]) and on each of the five Contours ([t1] - 


[t5]). The brightness of the tree trunks and branches fluctuates pixel to pixel with an amplitude related to the 
texture value. 


[tO] ... [t5] -- integers in the range 0 to 32. 
An error in reading an entry leaves the old value unchanged with return code 10. 


Wave Parameters 


“WaveType None/Sheen/Waves’ (ARexx) 

Select one of three Wave treatments. ‘None’ turns off all Waves, so the water will have a uniform 
brightness and texture. ‘Sheen’ varies the water brightness and texture on the scale of a few triangle widths 
to simulate sheens due to wind-ruffled water. ‘Waves’ means the water will be modeled to have Waves, with 

— characteristic Wavelengths which can be considerably smaller than a triangle width. The ‘Waves’ (but not 
the “Sheen’) will be drawn on a ‘Sea’ ground plane as well as on sea and optionally lake surfaces. 


re 
; Panorama version 3.0: Picture Perfect Fractal Landscapes 167 


‘LakeWavesOn,’ ‘LakeWavesOff’ (ARexx) 
Choose whether or not ‘Waves’ and ‘Sheen’ will be visible on lake surfaces as well as on sea 
surfaces. The Waves or Sheen will be present on lakes only if ‘LakeWavesOn’ is in effect and the 
“Wavetype’ is set appropriately. 


‘SkyReflOn,’ ‘SkyReflOff? (ARexx) 
Choose whether or not the sky color (taking into account the variation in the sky color between 
zenith and horizon) will be reflected off the Wave surface, with the amount of reflection varying with the 


local slope of the Wave. This effect requires that the ‘WaveType’ be ‘Waves,’ and is only visible in 24-bit or 
HAM rendering. 


“WaveSeed [n]’ (ARexx) 
A positive value for [n] will be accepted as the random seed used in generating both Wave and 
Sheen patterns. A value of 0 will set the ‘Wave Seed’ equal to the ‘Fractal Seed.’ 
[n] -- an integer in the range 0 to 2147483647. 
If an error or out of range the Fractal Seed is used and return code 10. 


‘SheenAmp [n.nn]’ (ARexx) 
Set the amplitude of the water brightness variations. The default value is 0.25, and values less than 
0.5 or so are recommended. The Sheen variations will be more prominent in 24-bit rendering than in normal 
Amiga rendering. 
[n.nn] -- a real number in the range 0.0 to 2.0. 
If an error or out of range the old value is preserved and return code 10. 


‘WaveAmp [n.nn)’ (ARexx) 
Set the amplitude of the Wave patterns on the water. A value of about 0.1 is recommended. Values 
much larger than this will make the Waves heavily shadowed for typical sun angles. 
[n.nn] -- a real number in the range 0.0 to 1.0. 
If an error or out of range the old value is preserved and return code 10. 


‘NWaves [n]’ (ARexx) 

Set the number of Waves used to construct the Wave pattern. The more Waves the more complex 
the Wave pattern and the longer the rendering time. Except for the first ‘Main’ Wave, the Wavelengths are 
set randomly in relation to the “WaveSize’ parameter, such that each successive Wave has a Wavelength 
smaller than the previous Wave by 5 per cent on average. The default value of NWaves is 10. 

[n] -- an integer in the range 1 to 32. 
If an error or out of range the Fractal Seed is used and return code 10. 


‘WaveSize [n.nn]’ (ARexx) 
Set the overall size (i.e., Wavelength) of the Wave pattern in Panorama coordinates. The nominal 
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fundamental full Wavelength is 2 times this number. The Main Wave has a longer Wavelength by an 
amount set with the ‘Main WaveContrast’ parameter, and the remaining Waves have shorter Wavelengths. 
Remember that unless the camera is fairly close to the water, Waves of realistically short Wavelengths will 
not be resolved. The default value is 20.0, a compromise between realism and visibility. 
[n.nn] -- a real number in the range 0.1 to 1000.0. 
If an error or out of range the old value is preserved and return code 10. 


“WaveShape [n.nn]’ (ARexx) 

Vary the shape (i.e., the profile) of the Wave. Positive values for [n.nn] sharpen the Wave crest and 
broaden the Wave trough, while negative values do the reverse. The default value of 3.0 gives moderately 
sharp Wave crests. 

[n.nn] -- a real number in the range -6.0 to 6.0. 
If an error or out of range the old value is preserved and return code 10. 


‘Main WaveContrast [n.nn]? (ARexx) 

The exponential of the MainWaveContrast is the ratio of the Main Wave (half-)Wavelength to the 
nominal fundamental (half-) Wavelength set by the ‘WaveSize’ command. The randomly generated Waves all 
have Wavelengths less than the nominal fundamental Wavelength. The apparent amplitude of the Main Wave 
scales with its Wavelength, so the larger the ‘WaveContrast’ the more predominant is the Main Wave relative 


to the randomly generated Waves. The default value is 0.0, and a value of about 1.0 will give an impression 
of ocean swells. 


[n.nn] -- a real number in the range 0.0 to 2.0. 
If an error or out of range the old value is preserved and return code 10. 


‘MainWaveCenter [x.xx] [y-yy]’ (ARexx) 

Set the x-coordinate and y-coordinate (in the Panorama coordinate system) of the center of the 
longest Wavelength Wave. The Wave spreads out in a circular pattern from this center, so by locating the 
center appropriately relative to the observer you can control the direction of the predominant Wave. 

[n.nn] -- a real number in the range -9999.0 to 9999.0, 
If an error or out of range the old value is preserved and return code 10. 


“WavePhase [n.nn]’ (ARexx) 

Increasing the Wave Phase during an animation makes the individual Wave crests move outwards 
from the Wave centers. The shorter-wavelength Waves move more slowly in distance, but more rapidly in 
phase, than the longer-wavelength Waves, corresponding to the actual behavior of Waves in deep water. The 
value [n.nn] is the phase in degrees (one whole cycle is 0 to 360) of the ‘Main’ Wave, which has the longest 
Wavelength and longest period. For the other Waves, the change in their phase is proportional to the square 
root of the ratio of the Main Wave wavelength to their wavelength. To get smooth motion of the Waves the 
change in the WavePhase from frame to frame should be small enough that the change in phase of all the 
Waves is small. The default value of the WavePhase is 0.0. Tweened. 


[n.nn] -- a real number in the range -9999.0 to 99999.0, 
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If an error or out of range the old value is preserved and return code 10. 


Sky-Horizon Parameters 


‘SkyHorizonType [n]’ (ARexx) 
Sets the color model in which the interpolation between the horizon color and the Sky (Zenith) 

color will be done. If [n]=0, the ‘SkyColor’ is used for the whole sky. If [n]=1, the interpolation is in the _ 
RGB color scheme. If [n]=2, the interpolation is in the Hue-Luminance-Saturation (HLS) color scheme, 
modified to compensate for the varying apparent brightness of different hues with the same nominal 
brightness, with the hue interpolation around the color wheel done from R to G to B. If [n]=3, the HLS a 
interpolation is done in the sense R to B to G. 

[n] -- an integer in the range 0 to 3. 

If an error or out of range the old value is used and return code 10. 


‘HorizonHeight [n.nn]’ (ARexx) 

Sets how the horizon color approaches the zenith color as the angle of the line of sight above the 
horizon increases. The smaller the value the more rapidly the horizon color approaches the sky color going 
upward. The blending is proportional to the sine of the elevation angle of the line of sight when the value is 
1.0. Tweened. 

[n.nn] -- a real number in the range 0.0 to 1.0. ~ 
If an error or out of range the old value is preserved and return code 10. 


Haze Parameters 


‘HazeType [n]’ (ARexx) 

A value of 0 for [n] means no haze, 1 means ’realistic’ haze with the amount of haze increasing _ 
exponentially with distance, 2 means the amount of haze increases exponentially with the square of the 
distance. Type 1 and Type 2 haze effects are about equal for equal values of the haze density when looking 
through a distance of 8000 in Genesis units, which is all the way across the landscape. Use Type 2 if you 
want the foreground to be relatively clear while having a substantial amount of haze in the distance. Always 
use Type 1 for fog effects. Haze is only visible in 24-bit or HAM. 

[n] -- an integer in the range 0 to 2. 
If an error or out of range the old value is used and return code 10. 


_—_—_— 
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‘HazeDensity [n.nn]’ (ARexx) 


Set a value for the haze/fog density. Only applies to 24-bit rendering. For light haze effects use 
values less than about 1.0, for fog, vatues about 25.0. Th weened. 


[n.nn] -- a real number in the range 0.0 to 100.0. 
If an ertor or out of range the old value is preserved and return code 10, 


‘HazeHeight [n.nn)’ (ARexx) 


Set the top of the haze to a z coordinate of [n.nn]. For fog, the top of the haze should be below the 
height of the observer. Tweened. 


[n.nn] -- a real number in the range -10000.0 to 20000.0. 
If an error or out of range the old value is preserved and return code 10. 


Cloud Parameters 


‘CloudsOn,’ ‘CloudsOff’ (ARexx) 
Toggle clouds on and off. Cloud rendering is done.after landscape rendering is finished. 


“CloudSeed [n]’ (ARexx) 
A positive value for [n] will be accepted as the random seed used 
0 value will set the Cloud Seed equal to the Fractal seed, the default value. 
[n] -- an integer in the range 0 to 2147483647. 
If an error or out of range the Fractal Seed is used and return code 10. 


, 


in generating the cloud pattern. A 


‘CloudXPos [n.nn]’ (ARexx) 
Set the x-coordinate (in the Panorama coordinate System) of the “center” 
this and ‘CloudYPos’ to make clouds drift across the sky in an animation. Tweened 
[n.nn] -- a real number in the range -99000.0 to 99000.0. 
If an error or out of range the old value is preserved and return code 10. 


of the cloud pattern. Vary 


‘Cloud YPos [n.nn]’ (ARexx) 


Set the y-coordinate (in the Panorama coordinate system) of the “ 
Values are accepted between -99000.0 and 99000.0. Vary this and Cloud 
vertically in an animation. Tweened. 
[n.nn] -- a real number in the range -99000.0 to 99000.0. 
If an error or out of range the old value is preserved and return code 10. 


center” of the cloud pattern. 
Pos to make the cloud pattern drift 


‘CloudHeight [n.nn]’ (ARexx) 
Set the height of the cloud plane. The observer must be below the cloud plane for the clouds to be 
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visible, 
[n.nn] -- a real number in the range 1000.0 to 20000.0. : 
If an error or out of range the old value is preserved and return code 10. 


‘CloudSize [n.nn]’ (ARexx) 
Set the overall size (i.e., Wavelength) of the cloud pattern. 
[n.nn) -- a real number in the range 100.0 to 40000.0. 
If an error or out of range the old value is preserved and return code 10. 


‘CloudAngle [n.nn]’ (ARexx) 
Rotate the cloud pattern about its center. When [n.nn] is 0.0, the cloud x- and y-axes are aligned 
with the Genesis x- and y- axes. As [n.nn] increases the pattern rotates clockwise (looking down on it from 
above). : 
[n.nn] -- a real number in the range -360.0 to 360.0. 
If an error or out of range the old value is preserved and return code 10. 


‘CloudXYRatio [n.nn]’ (ARexx) 


Stretch the cloud pattern along the cloud y-direction by an amount equal to the inverse of [nnn]. 
Use values of [n.nn] about 0.2 to produce long cirrus streamers. 
[n.nn] -- a real number in the range 0.0 to 2.0. 
If an error or out of range the old value is preserved and return code 10. 


‘CloudThreshold [n.nn)’ (ARexx) a 


Vary the fraction of the sky covered by clouds. A value of 0.0 means about 50 percent coverage. 
{n.nn] -- a real number in the range -5.0 to 5.0. 


If an error or out of range the old value is preserved and return code 10. 


‘CloudFuzziness [n.nnj’ (ARexx) 
Vary the “thickness” of clouds. Clouds will have sharp edges when the value is small compared to 
1, and will be mostly dithered “cirrus” when the value is much larger than 1. 
[n.nn) -- a real number in the range 0.0 to 20.0. 
If an error or out of range the old value is preserved and return code 10. 


‘CloudContrast [n.nn]’ (ARexx) 
When [n.nn] is 0, the ‘Waves’ from which the clouds are constructed have no preferred orientation. 


When [n.nn] is large the clouds will tend to be organized in regular bands along the y-direction in the cloud al 
coordinates. 


[n.nn] -- a real number in the range 0.0 to 2.0. 
If an error or out of range the old value is preserved and return code 10. 
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WireFrame Rendering 


‘ContourTopsWire [h12] [h23} [h34] [h45} [h56]’ (ARexx) 

Set the heights of the boundaries between the wire mode Contours as fractions of the range between 
zmin and zmax. All Contours above a boundary for which the relative height is equal to 1.0 will not be 
present in the landscape. 

[h12] -- a real number in the range 0.0 to 1.0. 
[h23],[h34],[h45],[h56] real numbers between the next lower boundary height and 1.0. 
If an error or out of range the old value is preserved and return code 10. 


‘WireContourColor [Contour] [r] [g] [b]’ (ARexx) 
Set a custom color for a particular Contour in wireframe mode. 
[Contour] -- an integer in the range 1 to 6 labeling the wireframe Contour. 
[r],{g],[b] -- palette values. Each is an integer in the range 0 to 255, which is divided by 16 to get 
the Amiga palette value. 
If an error or out of range the old value is preserved and return code 10. 


‘WireSkyColor [r] [g] [b]’ (ARexx) 
Set a custom color for the sky in wireframe mode. 
[r],[g].[b} -- palette values. Each is an integer in the range 0 to 255, which is divided by 16 to get 
the Amiga palette value. 
If an error or out of range the old value is preserved and return code 10. 


“WireWaterColor [r] [g] [b]’ (ARexx) 
Set a custom color for all types of water in wireframe mode. 
[r].[g],[b] -- palette values. Each is an integer in the range 0 to 255, which is divided by 16 to get 
the Amiga palette value. 
If an error or out of range the old value is preserved and return code 10. 


Draw Commands 


All of the commands in this Section are ignored in a script loaded as a “Settings” file. 


‘DrawPic {[filename]}’ (ARexx) 
This command causes a picture or pictures to be created according to the current rendering settings. 
It functions somewhat differently as an ARexx and as a Picture Script command. The Picture Script 
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command does not take any [filename] argument. The completed picture will automatically be saved to a file 
unless saving has been canceled by a previous ‘StopSave’ command in the script. The picture filename is 
constructed from the filename of the script by deleting the “‘.scrpt” extension and replacing it with the 
number of the current picture, starting with “‘.0001” if ‘Alphabetical Order’ is in effect and with “.1” if 
“Numerical Order’ is in effect. All of the pictures will be saved to the directory in which the script file is 
located. 

When the ‘Tweens’ command is in effect each ‘Draw’ command after the first in the Script will = 
cause a series of pictures to be drawn, interpolating between the current keyframe and the previous 
keyframe. 

As an ARexx command, the [filename] argument is optional. When [filename] is present, the i 
picture will be saved to that file. [Filename] should include the complete directory path as well as the name 


of the file. Any spaces must enclosed by double quotes (" ). The absence of [filename] is equivalent to 
‘StopSave’ in a Picture Script. 


If the 24-bit option is enabled the picture will be saved as a 24-bit IFF file, or, if ‘StartHIAM?’ is 
currently enabled, the picture will be converted to HAM and saved as a HAM ILBM file. 

If ‘Hold Picture’ is enabled, either from the ‘Switches’ menu or from a ‘HoldPic’ script or ARexx 
command, the picture will remain in memory until the next picture (including preview pictures) is drawn or 
until it is erased with a ‘KillPic’? ARexx command. Otherwise the picture and any 24-bit picture data will be 
erased as soon as the action of the ‘Draw’ command is completed. As long as the picture and 24-bit data 
remain in memory the picture can be saved later as an Amiga ILBM file with a ‘SavePic’ ARexx command = 
or as a 24-bit file with a ‘SavelFF24’ ARexx command. 

If the Picture Script or the ARexx macro ends with a picture being displayed, press <F5> or click 
with the left mousebutton to return to the Control Window and resume operation of Panorama, 


If no landscape exists, or there is an error in execution, or <ESC> is pressed while the picture is 
being drawn, the return code is 20. 


‘Tweens [n]’ 
Set the number of “tween” frames to be drawn between each keyframe in a Picture Script. The 
value of [n] does not include the previous keyframe or the current keyframe. The range of allowed values is 


0 to 499. The initial value for Tweens can be altered using the Script requester that appears when you select 
“Exec Pic Script’ from the ‘Actions’ menu. 


‘StartHIAM,’ ‘StopHAM? (ARexx) 
“StartHAM’ sets a switch so that subsequent pictures created as the result of a Picture Script or an 
ARexx ‘Draw’ command with the 24-bit toggle and a Solid draw mode in effect will be automatically 
converted to HAM. Ifa picture is then saved in an automatic mode, it will be saved as a HAM picture. 
“StopHAM’ cancels this option. 


‘FixHAMPalette,’ ‘FreeHAMPalette’ (ARexx) 
Use the ‘FixHAMPalette’ command in a Picture Script or from ARexx to ensure that the HAM 
palette remains the same for subsequent HAM pictures from the script, which is desirable if the pictures are 
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to be used as frames in an animation. In the absence of this command, the palette will be optimized 

independently for each HAM picture. The ‘FixHAMPalette’ command will only take effect if a HAM 
_ picture has been created previously. Once turned on, the fixed palette option can be turned off with the 
“FreeHAMPalette’ command. 

In ARexx, the ‘FixHAMPalette’ command applies only to the next picture drawn. Each new 
picture requires a new command to keep the palette fixed. 


‘StartSave,’ ‘StopSave’ 
ae ‘StartSave’ sets a switch so that pictures drawn fro: 
a file. ‘StopSave’ means that future pictures will not be sav 

_ARexx commands. 


_ As long as ‘StartSave’ is in effect, regardless of whether a filename is given as an argument to the 


‘DrawPic’ command, the picture drawn is held in memory, along with the 24-bit data if “24BitsOn’ is in 
effect. Subsequent ARexx commands can then save this picture in either Amiga ILBM format (using the 
“SavePic’ ARexx-only command) or in 24-bit IFF format (using the ‘SavelFF24’ ARexx- 


m a Picture Script will be automatically saved to 
ed toa file automatically. Note that these are not 


only command). 


‘StartPreview,’ ‘StopPreview’ (ARexx) 


With ‘StartPreview’ in effect all pictures will be drawn in preview wireframe mode, regardless of 
— the draw mode set by the ‘DrawMode’ command. ‘StopPreview’ restores the normal draw mode. 


‘ShowPic,’ ‘HidePic’ (ARexx) 

_ Sets a switch determining whether subsequent pictures will be visible or hidden as they are being 

drawn from a picture script or an ARexx macro. Pictures drawn from a menu command in Panorama are not 
affected, except that if a Picture screen is present when the command is executed, the picture screen is 
Opened in the front or opened behind the Amiga display, respectively. ‘ShowPic’ is the default, but hiding 
the picture screen may speed up the drawing somewhat if the screen in front is a 4-color screen. Another 
reason for using ‘HidePic’ is to minimize disruptions when you are Operating another program while 
Panorama is executing a picture script or an ARexx macro in the background. 


Panorama version 3.0: Picture Perfect Fractal Landscapes 


175 


‘ 


Appendix G: 
Commands for ARexx only 


Picture management 


‘HoldPic’ 
Set a switch to keep pictures in memory after being drawn. 


*KillPic’ ; 
Close Panorama picture screen and terminate ‘HoldPic’ mode. 


‘SavePic [filename]’ 


Save a picture in the appropriate Amiga ILBM format. The picture must be stored in memory, either 
created interactively or created with an ARexx or Picture Script ‘Draw’ command while ‘HoldPic’ is in 
effect. 


If the picture is not available, if the filename is missing, or if there is an error during the save, the 
return code is 20. 


‘SaveIFF24 [filename]? 
Save a picture in 24-bit IFF format. The 24-bit data must be stored in memory. 


If the 24-bit data is not available, the filename is missing, or there is an error during the save, the 
return code is 20. 


‘SaveSettings [filename]? 
Save the current settings to a file with the path and name given by [filename]. You should include 
the “set” extension in the filename. The return code is 20 if no filename is given or if the file cannot be 
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opened. The return code is 10 if an error occurs during saving the settings, and the file is preserved. This 
command is primarily of use when writing a general purpose ARexx program, 


Fractal Parameters 


*Fractal[ndex [n.nnj’ 
Set the Fractal Index. 
[n.nn] -- a real number in the range 1.0 to 3.0. 


If an error or not in range, then return code 10 and the previous value is preserved. 


‘ReliefBias [n.nn] {HighOnly/HighLow)’ 

Set the Relief Bias parameter and optionally indicate whether it should be in effect only for 
triangles whose height has the same Sign as the parameter (HighOnly) or for triangles at all elevations 
(HighLow). 

[n.nn] -- a real number in the range -10.0 to 10.0. 
If an error or not in range,then return code 10 and the previous value is preserved. 


‘VerticalOffset (n.nn]’ 
Set the Vertical Offset parameter. The default is 0.0. 
[n.nn] -- a real number in the range -2.0 to 2.0. 
If an error or not in range then return code 10 and the previous value is preserved. 


‘MeanderSlope [n.nn]’ 


Set the slope along a river below which meandering of the river is at maximum. The default is 0.02. 
{n.nn] -- a real number in the range 0.0 to 10.0. 
If an error or not in range, then return code 10 and the previous value is preserved. 


‘RescaleOld [factor]’ 
Rescale old heights only, by the factor given. 
[factor] -- a real number in the range 0.1 to 10.0. 
If an error then return code 10 and the factor is 1.0. 


‘PermSpringsOn, PermSpringsOff’ 
Toggie making springs permanent at the next Recursion Level. 


‘JiggleOn’, ‘JiggleOff’ 
Toggle the “jiggle mode.” 


‘RerunRiversOn, RerunRiversOff? 
Toggle rerunning existing rivers before starting calculation of the next Recursion Level. 
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‘IslandModeOn, IslandModeOff’ 
Toggle constraints on the heights of new points at the edge of the landscape. 


Landscape Construction and Manipulation 


“NewScape [seed] [spring code] {[springprob]}’ 
Erase the old landscape from memory and generate a new landscape to Level 1. 

[seed] -- an integer in the range -1 to 2147483647. or 

If [seed]>0 it is the Fractal Seed for the new landscape. If [seed]=0 a new Fractal Seed will be 
taken from the system clock. If [seed]=-1 and the data is available, the initial heights and the Fractal Seed 
will be taken from the previous landscape. In the last case, if there is no previous landscape the Fractal Seed 
is taken from the system clock and the return code set to 10. 

[spring code] -- an integer in the range -1 to 2 that determines how the permanent springs are 
selected for Level 1. A value of 0 means no permanent springs; a value of 1 means the initial random springs 
are made permanent; a value of 2 means all acceptable non-redundant points at Level 1 are made permanent ~“ 
springs; a value less than 0 means the Level 1 permanent springs from the previous landscape are used, if 
possible. If not, the return code is 10 and the initial random springs are used. 

[springprob] -- optional new value for the Spring Probability. Affects only initial landscape i 
generation. Must be in the range 0.0 to 1.0, or return code 10. Otherwise, the return code is 10 and the 
default value is 1. If insufficient memory is available, the return code is 30 and Panorama terminates. 


‘IncreaseLevel {[springprob]}’ 
Increase the Recursion Level by one. 
{springprob] -- optional new value for Spring Probability. Affects only the current Recursion 
Level. Must be in the range 0.0 to 1.0, or return code 10. 
Return code 20 if current Recursion Level is 0 or 5 or if insufficient memory is available. 


‘Lakes [n]’ 
Fill or empty lakes at the current Recursion Level. Erases any rivers present. 

[n] -- an integer in the range -1 to 1000. ; 

If positive or 0, then fill lakes until no more than this number of lakes are left unfilled. If [n]=-1, 
then empty all lakes and free the memory in the lake arrays. An error gives return code 10 and a default of 0. 
The filling process can be terminated by clicking EXIT’ or the *Close’ gadget of the requester that appears, 
or by pressing <ESC>. Clicking EMPTY’ will empty all the lakes. 

The return code is set to 10 if there is any user intervention. 

If Level 0 or insufficient memory for lake arrays, then return code 20.. c 
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— ‘Rivers [spring level] [# rivers from lakes]? 
Run rivers from permanent springs and lakes. Erases any pre-existing rivers. 
[spring level] -- an integer in the range -1 to 5. 


_ If [n]>0,then all permanent springs created up through this Recursion Level will act as sources for 
rivers, IF the number is greater than the current Recursion Level all permanent springs are shown and the 
return code is 10. If [n]=0, there are no rivers from permanent springs. If [n}=-1, then erase all rivers. 

If an error or no entry, then the command is aborted and the return code is 20. 

[# rivers from lakes] -- an integer in the range 0 to 2500. 

Specifies the number of lakes which will be sources of rivers, selected from those most recently filled 
up to the total number of full lakes. A lake already shown is counted against the total. If an error or no entry 
then no lakes are independent sources of rivers, and the return code is 10. 

If Level 0 then return code 20. 


> 


_ ‘RoughenSeed [seed]? 
Set a new seed for the random number generator for use in the “‘RoughenScape’ command. 


[seed] -- an integer in the range 0 to 2147483647. If [seed] is 0 then the Fractal Seed value is used. 
oat If Level 0 then return code 20. 


*RoughenScape [amt]? 
Add random height fluctuations to an existing landscape, excluding points on active rivers. The 
fluctuations in active lakes and adjacent to active rivers are constrained to preserve the lakes and rivers. 
[amt] -- a real number scaling the amplitude of the fluctuations, with a value of 1.0 corresponding 
to the current fractal fluctuation amplitude. Values between 0.0 and 2.0 are accepted. The menu selections 
correspond to values of 0.5 and 1.0. 
If [amt] is out of range or not a valid number, the return code is 10 and a value of 0.5 is used. 


= *SmoothScape [amt]? 


Smooth the current landscape, excluding points on active rivers. The new heights adjacent to active 
rivers are constrained to preserve the river. 


{amt] -- a real number in the range between 0.0 and 1.0 specifying the amount of smoothing. The 
menu selections are 0.2 and 0.4. 


If [amt] is out of range or not a valid number, the return code is 10 and a value of 0.2 is used. 


‘ChangeHeight [i] [j] [newZ]’ 


Change the height of the point labeled by i and j. Rivers are erased and lakes emptied before this 
command is executed.. 


— [i] -- an integer which labels the column in which the point lies. This must be even if j is even and 
odd if j is odd. The center of the landscape is i=j=0. Error gives return code 20. 


[}] -- an integer which labels the row in which the point lies. Error gives return code 20. 
a 
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[newZ] -- the real number in the range -100000.0 to 100000.0which ‘is to be the new height of the 
point. Error gives return code 10, and leaves the height unchanged. 


If Level 0, or lakes are present, or the label does not correspond to a point in the landscape then = 
return code 20. 


‘AddSpring [i] [j) 
Add a new permanent spring at the point labeled by i and j. 


[i] -- an integer which labels the column in which the point lies. This must be even if j is even and 
odd if j is odd, or the command will abort with return code 20. 


[j] -- an integer which labels the row in which the point lies. Error gives return code 20. 
If Level 0 or if the label does not correspond to a point in the landscape, then return code 20. If a 


spring is already at the point, then no new spring is created and the return code is 10. There can be at most ; 
999 permanent springs in a landscape. : 


‘KillSpring (i) G7 | 
Remove the permanent spring at the point labeled by i and j. = 
[i] -- an integer which labels the column in which the point lies. This must be even if j is even and 
odd if j is odd. 
[j] -- an integer which labels the row in which the point lies. Error gives return code 20. 


If Level 0 or if the label does not correspond to a point in the landscape, then return code 20. If 
there is no spring at the point, the return code is 10. 


‘SpringDepth [n) [nd]’ - 
Set the initial depth [nd] of the river from the [n]th permanent spring. If [nd]=-1 the spring is 
rendered inactive and generates no river at all. The-river is drawn as a thin line initially if [nd] is 0 and is at 
its maximum depth (and width) if [nd] is 120 or greater. . _ 
[n] -- an integer in the range 1 to 64. 
[nd] -- an integer in the range -1 to 127. 


If [n] or [nd] is out of range, or the [n]th permanent spring does not exist, then return code 20 and 
the command is aborted. 


‘LoadData [filename]? 


Load height and (if present) lake data for a new landscape from the file with the path and name 


given by [filename]. If an error then return code 20. The random number generator is reset with the seed in 
the file. 


‘SaveData [filename]’ 
Save height data for the current landscape and Recursion Level in the file with the path and name 


given by [filename]. You should include the “data” extension in the filename. If lakes exist and there is = 
room on the disk, the lake data will be appended to the data file. 


If saving lakes is prevented by insufficient space, the return code is 10. 
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If no landscape exists or there is an error when saving the return code is 20. Any partially created 
file is deleted following an error. 


‘ReduceLevel’ 


Reduce the Recursion Level by one. If this is not possible because the current level is less than 2 or 
= because the data is not available, the return code is 20. If memory is not available to restart the new level, 
the return code is 30. 


‘Quit’ 
Tells Panorama to terminate. 


Local Analysis 


‘PolarToXY [d.dd] [c.ce]’ 
Convert the camera position as a distance from the center of the landscape and a compass angle to 
Cartesian x,y coordinates. The values of x and y are returned in the RESULT string. 
[d.dd] -- a real number in the range 0.0 to 200000.0. 
[c.cc] -- a real number in the range -720.0 to 720.0. 
If an error or out of range then return code 20. 


“XYtoLJ [x.xx] [y.yy]’ 
Given horizontal coordinates x,y of a location within the landscape, this command returns the labels 
i,j of the nearest point in the landscape in the RESULT string. 
[x.xx] -- a real number in the range -5000.0 to 5000.0, increasing South to North. 
a [y-yy] -- a real number in the range -5000.0 to 5000.0, increasing East to West. 
If the location x,y is not within the landscape or some other error occurs, then return code 20. 


‘TJtoXY [i] {i]’ 
Given the labels [i],{j] of a point in the landscape, returns the horizontal Cartesian coordinates X,Y 
of the point in the RESULT string. 
[i],[j] -- integers, either both even or both odd consistent with the point labeling scheme. 


If an error, or if [i],[j] are not valid labels for a point in the landscape at the current Recursion 
Level, then return code 20. 


= ‘GetHeightAt [x.xx] [y.yy]’ 
Returns the height of the nearest point in the landscape to the Panorama coordinate location (not 
necessarily over the landscape) specified. The height returned in the RESULT string is the highest of the 
= land height, the height of any lake present at the point, and the sea level height. 
[x.xx] -- a real number in the range -10000.0 to 10000.0, the x-coordinate of a location in the 
Panorama world. Ertor gives return code 20. 
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[y-yy] -- a real number in the range -10000.0 to 10000.0, the y-coordinate of a location in the 
Panorama world. Error gives return code 20. 


If Recursion Level 0, then return code 20. 


‘GetMinMaxZ’ 
Finds the minimum and maximum heights of points in the landscape and returns the values in the 
RESULT string (minimum z first). 


‘GetRecursionLevel’ 


The current Recursion Level is returned in the RESULT string. This command is included to 
facilitate writing general purpose ARexx programs. 


‘GetSpringPos [n]’ 
Returns the i and j position labels for the nth permanent spring in the RESULT string. 
[n] -- a postive integer. 
If n<0 or if n is larger than the total number of permanent springs, then return code 20. 


‘NextRivPt [i] [j]’ 


Returns in the RESULT string the i and j labels of the neighboring point downstream along a river 
through the point labeled by the input i and j. If no river goes downstream from the point, then the i and j 
values returned are identical to the input values. 


[i] -- an integer which labels the column in which the point lies. This must be even if j is even and 
odd if j is odd. 

{j] -- an integer which labels the row in which the point lies. 

If i and j are not valid point labels, then return code 20. 


‘GetLakeAt [i] [j]’ 


Returns the number of the lake present at the point labeled by i and j, or 0 if there is no lake at the 
point. The value is negative if the point is on the edge of the lake, and positive if it is in the interior. 
If no lakes exist in the landscape or i and j are not valid point labels, the return code is 20. 


‘GetLakeOutlet [n]’ 
Returns the i and j labels for the lowest point adjacent to the rim of lake number n, if lake n is full. 
This point is on the outlet river one triangle edge length downstream from the actual outlet of the lake. 
[n] -- a positive integer. 
If an error, or n<=0, or n is larger than the total number of lakes, then return code 20. If lake 
number n is not full, so there can be no outlet river, then the return code is 10. 


‘GetPanoramaUnit’ 


Returns in the RESULT string the internal Panorama unit of distance in meters. By default is 1.0, 
but will have meaning for Panorama data generated from DEMs by GeoRama. 
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‘GetPanoramaZ Offset’ . 
— Returns the “absolute” height above sea level in (normally) meters corresponding to 0 hei ght in 
Panorama coordinates. By default is 0.0, but is meaningful for Panorama data generated by GeoRama. For 
a few DEMs the vertical height unit is feet, in which case this number may be feet above sea level. 


‘GetPanoramaCenterWE/SN’ 
Returns the West-to-East and South-to-North coordinates of the center of the Panorama patch in 
units of the spacing of the DEM profiles and points for DEM data imported via GeoRama. The units will 


vary with DEM type, but are Universal Transverse Mercator coordinates in units of 30 meters for 7.5 arc 
minute DEMs. For fractal landscapes both values will be 0. 


Statistics 


aa ‘GetRivLength [n]’ 
Returns two measures of the length of the river from the nth permanent spring, the straight-line 
distance from the spring to the end of the river and the actual length of the river following all the meanders. 
ne The river only ends at the edge of the landscape or if it reaches a point which is a local minimum, regardless 
of the sea level setting. If rivers have been erased you must rerun the rivers or both lengths will be 0. 
[n] -- a postive integer. 
If an error or n<=0 or n is larger than the total number of permanent springs, then return code 20. 


‘NumberRivPts’ 
Returns in the RESULT string the number of points in the landscape on rivers. 


‘GetAreaRatio’ 
Returns the ratio of the actual area (in the absence of any lakes or sea) of the portion of the 
= landscape identical in horizontal size to the Level 1 landscape to its area projected on a horizontal plane. 


‘GetFractalDim’ 
Returns an estimate of the fractal dimension of the landscape, based on the current and previous 
Recursion Levels. Can only be used at Recursion Levels 4 and 5 (return code 20 otherwise). 


‘GetVariance [filename]? 
Calculates averages of how the mean squared difference in height between two points scales with 
the distance between the points, and stores the results in an Amiga text file with the name specified. Can 
only be used at Recursion Levels 4 and 5. 
— [filename] -- the name (including path) of a file for storing output data. 
Return code 20 if no filename given, an error in opening the file, or Recursion Level too low. 
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97, 101, 112, 113, 114, 118, 121, 122, 123, 130, 132, 
137, 138, 140, 142, 154, 164, 167, 168, 169 

timer 15, 16, 30 

title bar 22, 30, 33, 66, 102, 120, 139, 142 

titlebar 50, 56, 121, 139, 140, 143 

trees 19, 20, 23, 30, 36, 39, 41, 44, 47, 69, 72, 73, 
74, 105, 126, 127, 135, 137, 138, 161, 162, 166, 167 

triangle boundaries 110 

triangle edge length 58, 67, 76, 87, 110, 114, 138, 182 


tributaries 113 


tween 79, 85, 92, 93, 94, 95, 96, 124, 154, 155, 156, 
157, 159, 169, 170, 171, 174 


tweens 93, 95, 96, 174 
two-dimensional 27, 39, 73, 83, 138 
U2 23, 133 


unit 36, 37, 50, 55, 74, 76, 78, 81, 87, 88, 96, 106, 
117, 118, 119, 120, 121, 122, 123, 124, 126, 127, 167, 
170, 182 

Upward Bias 

vertex 40, 41, 88 

vertical 23, 25, 27, 29, 36, 41, 42, 58, 59, 60, 61, 62, 
87, 88, 93, 97, 107, 108, 109, 113, 120, 130, 131, 132, 
133, 155, 156, 157, 171, 177, 183 

vertical scale 23, 41, 42, 58, 59, 61, 62, 88, 93, 97, 
113, 131, 132, 133, 157 

vertical view angle 27, 29, 155 

vertices 40, 87, 88 

Video Toaster 37 

view __ 17, 19, 22, 23, 25, 27, 29, 30, 31, 36, 41, 46, 
49, 53, 62, 73, 80, 82, 85, 87, 92, 93, 94, 95, 117, 122, 
130, 131, 133, 135, 136, 138, 145, 146, 147, 154, 155, 
156, 159, 162, 174, 175 . 


Von Koch curve 105, 106, 107, 112 


water 15, 16, 19, 23, 33, 39, 42, 44, 48, 49, 50, 75, 
76, 77, 78, 79, 97, 124, 125, 126, 133, 138, 145, 157, 
160, 162, 163, 167, 168, 169, 173 


waterfalls 19, 39, 42, 44, 49, 126, 157, 160 

wave amplitudes 84,107 ~ 

wavelengths 77, 78, 79, 108, 167, 168, 169 

waves —_20, 23, 30, 41, 44, 45, 75, 76, 77, 78, 79, 84, 
97, 107, 108, 109, 162, 167, 168, 169, 172 


west 23, 25, 29, 33, 42, 43, 45, 66, 67, 72, 
81, 87, 113, 114, 118, 122, 123, 130, 137, 160, 162, 
163, 181, 182 


white 15, 16, 23, 30, 33, 47, 119, 131, 133 

wiggliness 30 

wiggling 111, 112 

wireframe 17, 31, 32, 36, 38, 39, 48, 49, 50, 62, 66, 67, 
94, 97, 146, 156, 173, 175 

Wireframe HL 36 

wireframe modes 36, 67 

wires 31, 49, 173 


110, 114, 130 


WorkBench 21, 37, 50, 51, 101, 117, 137, 142, 
144, 147, 156 

X-axis 87, 88 

X-coordinate 88, 118, 169, 171, 181 

y-coordinate 88, 118, 169, 171, 182 

z input mode 32 
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Help With Panorama 


Push-Button Publishing has arranged for AmiGadget magazine to provide an online help facility, in 
case you have trouble understanding Pancrama’s many functions and features. Your questions will be 
answered individually, as soon as possible. In addition the magazine will publish, both electronically and 
in paper form, the most frequently asked questions (and the answers), as well as tips and additional 
material that you might find useful. 

You can get help with Panorama by directing an electronic message via Computer BBS, Usenet or 
other electronic messaging system to any of the following addresses: 

Electronic mail: amigadget@cup.portal.com 

US. Mail: AmiGadget Magazine, P.O. Box 1696, Lexington, SC 29072 

Fax: 803-957-7495 

The magazine has electronic access to the database of registered users. The help facility is limited 
to registered users of Panorama. Please mail your Panorama Registration Card with your questions, or 
include your product’s serial number. Voice telephone support is offered on a fee basis. 


can 
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